PerfDeleteInstance 関数 (perflib.h)
PerfCreateInstance 関数によって作成されたカウンター セットのインスタンスを削除します。 プロバイダーはこの関数を使用します。
構文
ULONG PerfDeleteInstance(
[in] HANDLE Provider,
[in] PPERF_COUNTERSET_INSTANCE InstanceBlock
);
パラメーター
[in] Provider
プロバイダーのハンドル。 CTRPP ツールによって生成されたハンドル変数を使用します。 変数の名前については、provider 要素の symbol 属性を参照してください。
Windows Vista: PerfStartProvider 関数はハンドルを返します。
[in] InstanceBlock
削除 する カウンター セットのインスタンスを含むPERF_COUNTERSET_INSTANCE構造体。
戻り値
関数が成功すると、ERROR_SUCCESSが返されます。
関数が失敗した場合、戻り値は システム エラー コードです。
注釈
プロバイダー プロセスが異常終了すると、割り当てられたすべてのインスタンスが解放されます。
プロバイダーは、インスタンスを削除するタイミングを決定します。 カウンター データの方が静的な場合、プロバイダーはクリーンアップ時にインスタンスを削除できます。 たとえば、コンピューター上のプロセッサの数は静的と見なされるため、プロセッサのカウンター データを提供するプロバイダーは、クリーンアップ時にコンピューター上の各プロセッサのインスタンスを削除できます。 ディスクカウンターやプロセス カウンターなど、より動的なカウンターの場合、プロバイダーは、USB デバイスの削除またはプロセスの終了に応じてインスタンスを削除します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | perflib.h |
| Library | Advapi32.lib |
| [DLL] | Advapi32.dll |