IWSDDeviceHost::RetireService メソッド (wsdhost.h)

RegisterService を使用して登録されたサービスオブジェクトの登録を解除し、デバイスホストメタデータからサービスを削除します。

構文

HRESULT RetireService(
  [in] LPCWSTR pszServiceId
);

[in] pszServiceId

削除するサービスの ID。

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

リターンコード	説明
S_OK	メソッドが正常に完了しました。
E_POINTER	pszServiceId は NULL です。
E_INVALIDARG	pszServiceId の文字数がWSD_MAX_TEXT_LENGTH (8192) を超えているか、登録されているサービスの一覧で pszServiceId が見つかりませんでした。
E_FAIL	メソッドが失敗しました。ホストが初期化されていないため、失敗した可能性があります。 Init を呼び出して、デバイスホストを初期化します。

デバイスホストは、サービスの登録が解除された後、サービスオブジェクトへの参照を解放します。 RetireService が完了した後、サービスオブジェクトはコールバックを受け取りません。