CryptGetDefaultOIDDllList 函式 (wincrypt.h)
CryptGetDefaultOIDDllList函式會針對指定的函式集和編碼類型,取得包含已註冊之預設物件識別碼的 DLL 檔案名清單, (OID) 函式。
語法
BOOL CryptGetDefaultOIDDllList(
[in] HCRYPTOIDFUNCSET hFuncSet,
[in] DWORD dwEncodingType,
[out] WCHAR *pwszDllList,
[in, out] DWORD *pcchDllList
);
參數
[in] hFuncSet
呼叫 CryptInitOIDFunctionSet之前取得的函式集控制碼。
[in] dwEncodingType
指定要比對的編碼類型。 目前只會使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;不過,未來可能會新增其他編碼類型。 若要比對目前的編碼類型,請使用:
X509_ASN_ENCODING |PKCS_7_ASN_ENCODING
注意 需要憑證或 訊息編碼類型 。 X509_ASN_ENCODING是預設值。 如果指出該類型,則會使用它;否則,如果指出PKCS7_ASN_ENCODING類型,則會使用它。
[out] pwszDllList
緩衝區的指標,用來接收零個或多個以 Null 結尾的檔案名清單。 傳回的清單會以終止 的 Null 字元終止。 例如,兩個名稱的清單可能是:
L「first.dll\0」 L「second.dll\0」 L「\0」
若要擷取緩衝區必須保留的寬字元數,此參數可以是 Null。 如需詳細資訊,請參閱 擷取未知長度的資料。
[in, out] pcchDllList
DWORD的指標,指定pwszDllList參數所指向之傳回清單的大小,以寬字元為單位。 當函式傳回時, pcchDllList 參數所指向的變數會包含儲存在緩衝區中的寬字元數目。
注意 處理緩衝區中傳回的資料時,應用程式必須使用傳回之資料的實際大小。 實際大小可能會稍微小於輸入中指定的緩衝區大小。 在輸入時,緩衝區大小通常會指定夠大,以確保最大可能的輸出資料會放入緩衝區中。 在輸出時,會更新此參數所指向的變數,以反映複製到緩衝區的資料實際大小。
傳回值
如果函式成功,函式會傳回非零 (TRUE) 。
如果函式失敗,它會傳回零 (FALSE) 。 如需擴充的錯誤資訊,請呼叫 GetLastError。
此函式具有下列錯誤碼。
傳回碼 | 描述 |
---|---|
|
如果 pwszDllList 參數指定的緩衝區不足以保存傳回的資料,函式會設定ERROR_MORE_DATA程式碼,並以寬字元儲存 pcchDllList指向的變數中所需的緩衝區大小。 |
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式 |UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式 |UWP 應用程式] |
目標平台 | Windows |
標頭 | wincrypt.h |
程式庫 | Crypt32.lib |
Dll | Crypt32.dll |