WsGetPolicyAlternativeCount 関数 (webservices.h)

  • [アーティクル]

ポリシー オブジェクトで使用できる代替手段の数を取得します。 代替カウントは、 WsMatchPolicyAlternative を使用して各代替をループ処理するために使用できます。

メモ ポリシー オブジェクトは、この関数が呼び出されるまで一部の処理を遅らせる場合があります。 処理が失敗した場合、ポリシー オブジェクトは WS_POLICY_STATE_FAULTED 状態に設定されます。
 

構文

HRESULT WsGetPolicyAlternativeCount(
  [in]           WS_POLICY *policy,
  [out]          ULONG     *count,
  [in, optional] WS_ERROR  *error
);

パラメーター

[in] policy

代替候補をカウントする WS_POLICY オブジェクトへのポインター。

[out] count

代替の数の値へのポインター。 これは 0 である可能性があります。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
E_INVALIDARG
 プロパティ ID がこのオブジェクトでサポートされていないか、指定されたバッファーが値に対して十分な大きさではなかった。
E_OUTOFMEMORY
 メモリ不足。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

解説

各代替手段は、ポリシー内で一意であることが保証されないことに注意してください (重複している可能性があります)。

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリ |UWP アプリ]
対象プラットフォーム Windows
ヘッダー webservices.h
Library WebServices.lib
[DLL] WebServices.dll