IFunctionInstance::GetID メソッド (functiondiscoveryapi.h)

[関数の検出は、[要件] セクションで指定されたオペレーティング システムで使用できます。 これは、以降のバージョンで変更または使用できない可能性があります。

関数インスタンスの識別子文字列を取得します。 この識別子を保存し、後で IFunctionDiscovery::GetInstance を使用して同じ関数インスタンスのクエリを再実行するために使用できます。

構文

HRESULT GetID(
  [out] WCHAR **ppszCoMemIdentity
);

パラメーター

[out] ppszCoMemIdentity

関数インスタンス識別子の文字列。 この文字列のサイズに上限はありません。

この文字列は、関数探索によって生成される構成された文字列です。 これには、プロバイダー インスタンス識別子文字列が部分文字列として含まれます。 プロバイダー識別子の詳細については、「 IFunctionInstance::GetProviderInstanceID」を参照してください。

組み込みプロバイダーによって返される関数インスタンスの場合、この識別子は、リソースが切断されて再接続された場合でも、システム上のリソースを一意に識別することが保証されます。 カスタム プロバイダーによって返される関数インスタンスの場合、プロバイダーに一意のプロバイダー識別子がある場合、関数インスタンス識別子は一意です。

この識別子は、プログラムで操作または製造しないでください。 文字列は、関数インスタンスの取得と比較のためにのみ使用する必要があります。

CoTaskMemFree を使用して、このバッファーを解放してください。

戻り値

可能な戻り値は次のとおりですが、これらに限定されません。

リターン コード	説明
S_OK	メソッドは正常に完了しました。
E_INVALIDARG	ppszCoMemID の値が無効です。
E_OUTOFMEMORY	メソッドは、この操作を実行するために必要なメモリを割り当てることができません。

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	functiondiscoveryapi.h
[DLL]	FunDisc.dll

こちらもご覧ください

IFunctionInstance