CertGetValidUsages 関数 (wincrypt.h)

CertGetValidUsages 関数は、証明書の配列内のすべての証明書の有効な使用法の積集合で構成される使用法の配列を返します。

構文

BOOL CertGetValidUsages(
  [in]      DWORD          cCerts,
  [in]      PCCERT_CONTEXT *rghCerts,
  [out]     int            *cNumOIDs,
  [out]     LPSTR          *rghOIDs,
  [in, out] DWORD          *pcbOIDs
);

パラメーター

[in] cCerts

確認する配列内の証明書の数。

[in] rghCerts

有効な使用を確認する証明書の配列。

[out] cNumOIDs

配列内のすべての証明書の有効な使用法の積集合として見つかった有効な使用量の数。 すべての証明書がすべての使用に対して有効な場合、 cNumOIDs は負の 1 (–1) に設定されます。

[out] rghOIDs

rghCerts 配列内のすべての証明書によって共有される有効な使用法のオブジェクト識別子 (OID) の配列。 メモリ割り当てのためにこの構造体のサイズを設定するには、このパラメーターを NULL に できます。 詳細については、「不明な 長さのデータの取得」を参照してください。

[in, out] pcbOIDs

rghOIDs 配列と指す文字列のサイズをバイト単位で指定する DWORD 値へのポインター。 関数が戻るときに、 DWORD 値には配列に必要なバイト数が含まれます。

戻り値

関数が成功すると、戻り値は 0 以外になります。 関数が失敗した場合は、0 を返します。 拡張エラー情報については、 GetLastError を呼び出します。

要件