CryptEnumOIDFunction 函式 (wincrypt.h)

CryptEnumOIDFunction 函式會列舉 OID) 函式 (已註冊的物件識別符。 列舉的 OID 函式可以加以篩選,以包含其編碼類型、函式名稱、OID 或任何編碼類型、函式名稱和 OID 的組合所識別的函式。 針對符合選取準則的每個 OID 函式,會呼叫應用程式提供的回呼函式 pfnEnumOIDFunc

語法

BOOL CryptEnumOIDFunction(
  [in] DWORD                   dwEncodingType,
  [in] LPCSTR                  pszFuncName,
  [in] LPCSTR                  pszOID,
  [in] DWORD                   dwFlags,
  [in] void                    *pvArg,
  [in] PFN_CRYPT_ENUM_OID_FUNC pfnEnumOIDFunc
);

參數

[in] dwEncodingType

指定要比對的編碼類型。 將此參數設定為 CRYPT_MATCH_ANY_ENCODING_TYPE符合任何編碼類型。 請注意,如果未指定CRYPT_MATCH_ANY_ENCODING_TYPE,則需要憑證或 訊息編碼類型 。 如果包含憑證編碼類型的低序字是非零,則會使用它;否則,會使用包含訊息編碼類型的高序字。 如果同時指定兩者,則會使用低序字的憑證編碼類型。

目前定義的編碼類型如下:

  • CRYPT_ASN_ENCODING
  • X509_ASN_ENCODING
  • PKCS_7_ASN_ENCODING
  • CRYPT_MATCH_ANY_ENCODING_TYPE

[in] pszFuncName

執行不區分大小寫比對搜尋的函式名稱。 將此參數設定為 NULL 會導致找到任何函式名稱的相符專案。

[in] pszOID

如果 pszOID 的高序字不是零, pszOID 會指定執行不區分大小寫比對搜尋的對象識別碼。 如果 pszOID 的高序字是零, pszOID 會用來比對數值對象識別碼。 將此參數設定為 NULL 會符合任何物件識別碼。 將此參數設定為 CRYPT_DEFAULT_OID只會將列舉限制為預設函式。

[in] dwFlags

保留供日後使用,且必須為零。

[in] pvArg

要傳遞至CRYPT_ENUM_OID_FUNCTION回呼函式之自變數 指標。

[in] pfnEnumOIDFunc

針對符合輸入參數的每個 OID 函式所執行的回呼函式指標。 如需詳細資訊,請參閱 CRYPT_ENUM_OID_FUNCTION

傳回值

如果函式成功,函式會傳回非零 (TRUE) 。

如果函式失敗,它會傳回零 (FALSE) 。 如需擴充錯誤資訊,請呼叫 GetLastError

規格需求

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

另請參閱

OID 支援函式