RoGetServerActivatableClasses 関数 (roregistrationapi.h)
呼び出し元プロセスのパッケージ ID で登録された、特定の実行可能ファイル (EXE) サーバーに登録されているアクティブ化可能なクラスを取得します。
構文
HRESULT RoGetServerActivatableClasses(
[in] HSTRING serverName,
[out] HSTRING **activatableClassIds,
[out] DWORD *count
);
パラメーター
[in] serverName
型: HSTRING
クラス登録を取得するサーバーの名前。 このサーバー名は、サーバーがアクティブ化されるときにコマンド ラインで渡されます。
[out] activatableClassIds
型: HSTRING**
サーバーがサービスを提供するために登録されているアクティブ化可能なクラス ID 文字列の呼び出し先割り当て配列。 WindowsDeleteString 関数を使用して、呼び出し元が文字列を解放する必要があります。 その後、 CoTaskMemFree を使用してバッファーを解放する必要があります。 サーバー (呼び出し元) は、これらのクラスのアクティブ化ファクトリを登録する役割を担います。
[out] count
型: DWORD*
activatableClassIds 配列で返されるアクティブ化可能なクラス ID の数。
戻り値
型: HRESULT
メソッドは成功 時にS_OK を返します。それ以外の場合は、次のようなエラー コードを返します。
リターン コード | 説明 |
---|---|
|
空のサーバー名が指定されているか、サーバーが登録されていないか、このサーバーのクラスが登録されていません。 |
|
このプロセスには、このサーバーの登録を読み取る十分なアクセス許可がありません。 |
注釈
RoGetServerActivatableClasses 関数を使用して、サーバーが提供するクラス名を取得します。 各クラス名に対して RoGetActivatableClassRegistration 関数を個別に呼び出して、個々のクラスの詳細を取得します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | roregistrationapi.h |
Library | Runtimeobject.lib |