PNS_CONTEXT_CONNECT_FN

NS_CONTEXT_CONNECT_FN コマンドは、ヘルパーの接続関数です。ヘルパーは、NetShell がそのヘルパーに接続できるようにする接続関数を公開します。NetShell は、他のヘルパー関数を呼び出す前に、ヘルパーの接続関数を呼び出します。

接続関数は、 RegisterContext 関数を使用して NetShell に登録されます。次に接続関数の例を示します。SampleConnect は、アプリケーション定義の関数名のプレースホルダーであることに注意してください。

成功した場合は NO_ERROR を返します。それ以外の戻り値はエラーを示します。

ヘルパーの接続関数は、コンテキストのダンプ関数が存在する場合はその呼び出しの前に、またすべてのコマンド関数の呼び出しの前に、NetShell によって呼び出されます。接続関数の呼び出し中には、2 つの処理を行う必要があります。

コンテキストがリモート操作可能な場合 (CMD_FLAG_LOCAL フラグが指定されていないことで示されます)、接続関数は次に操作対象となるコンピューターの名前を受け取り、そのコンピューターと通信できるかどうかを検証する必要があります。

コンテキストのコマンドが動的である場合、コンテキストは最新のコマンドセットを指定して RegisterContext を再度呼び出す必要があります。

各ヘルパーは、リモートコンピューターへの自身の接続を維持する責任があります。アクセスできない場合、ヘルパーは適切なエラーメッセージを表示し、接続関数で失敗を返さなければなりません。