共用方式為

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

在陣列中所有憑證的有效使用方式交集時，找到的有效使用次數。 如果所有憑證都適用于所有使用方式， cNumOID 會 設定為負一 (-1) 。

[out] rghOIDs

物件識別碼的陣列 (OID，) rghCerts陣列中所有憑證共用的有效使用方式。 此參數可以是 Null ，可設定此結構的大小以供記憶體配置之用。 如需詳細資訊，請參閱 擷取未知長度的資料。

[in, out] pcbOIDs

DWORD值的指標，指定rghOIDs陣列的大小，以位元組為單位，以及指向的字串。 當函式傳回時， DWORD 值會包含陣列所需的位元組數目。

傳回值

如果函式成功，則傳回非零的值。 如果此函式失敗，則傳回值為零。 如需擴充的錯誤資訊，請呼叫 GetLastError。

規格需求

   
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 wincrypt.h
程式庫 Crypt32.lib
Dll Crypt32.dll