ホーム › NetworkManagement.NetShell › PFN_HANDLE_CMD

PFN_HANDLE_CMD

コールバック

シグネチャ

DWORD PFN_HANDLE_CMD(
    LPWSTR pwszMachine,
    LPWSTR* ppwcArguments,
    DWORD dwCurrentIndex,
    DWORD dwArgCount,
    DWORD dwFlags,
    void* pvData,
    BOOL* pbDone
);

パラメーター

フィールド	型	説明
pwszMachine	LPWSTR	コマンドを実行するコンピューターの名前。コマンドがローカルコンピューターに適用される場合は null です。既定値は null です。コンテキストが接続関数を使用する場合、この引数は無視できます。
ppwcArguments	LPWSTR*	コマンドトークンのセットです。
dwCurrentIndex	DWORD	この関数が呼び出される前に最後に処理されたトークンの、ppwcArguments 内での現在のインデックスです。
dwArgCount	DWORD	ppwcArguments パラメーター内の引数の数です。
dwFlags	DWORD	現在の状態に関係するコマンドフラグです。
pvData	void*	データへのポインターです。親コンテキストの SubEntry 関数によって変更されない限り、値は null です。
pbDone	BOOL*	コマンド関数の完了後に NetShell を終了させるには、戻る前に pbDone に TRUE を設定します。pbDone パラメーターは、既定では FALSE に設定されます。

公式ドキュメント

FN_HANDLE_CMD コマンドは、ヘルパーのコマンド関数です。ヘルパーは、RegisterContext 関数の pTopCmds パラメーターおよび pCmdGroups パラメーターを通じてコマンドを公開します。次にコマンド関数の例を示します。SampleCommand は、アプリケーション定義の関数名のプレースホルダーであることに注意してください。

戻り値

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

解説(Remarks)

pwszMachine で指定されたコンピューター名は各関数に渡されるため、ヘルパーがコマンドを 1 つしか持たない場合に必要となるような接続関数は必須ではありません。複数のコマンドを持つヘルパーは、各コマンド関数にリモート処理のコードを重複して記述する代わりに、接続関数内にまとめて作成できます。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)