CryptGetOIDFunctionValue 函式 (wincrypt.h)

  • 發行項

CryptGetOIDFunctionValue函式會查詢與 OID 相關聯的值。 查詢會針對與 OID、函式名稱和編碼類型相關聯的特定具名值進行。 函式可以傳回查詢值、值、本身或兩者的類型。

語法

BOOL CryptGetOIDFunctionValue(
  [in]      DWORD   dwEncodingType,
  [in]      LPCSTR  pszFuncName,
  [in]      LPCSTR  pszOID,
  [in]      LPCWSTR pwszValueName,
  [out]     DWORD   *pdwValueType,
  [out]     BYTE    *pbValueData,
  [in, out] DWORD   *pcbValueData
);

參數

[in] dwEncodingType

指定要比對的編碼類型。 目前只會使用X509_ASN_ENCODING和PKCS_7_ASN_ENCODING;不過，未來可能會新增其他編碼類型。 若要比對目前的編碼類型，請使用 X509_ASN_ENCODING |PKCS_7_ASN_ENCODING。

[in] pszFuncName

包含 OID 函數集名稱之 Null 終止字串的指標。

[in] pszOID

如果 OID 的高序單字為非零， pszOID 是以 Null 結尾的 OID 字串指標，例如 「2.5.29.1」 或以 Null 結尾的 ASCII 字串，例如 「file」。如果 OID 的高序單字為零，則低序字會指定要當做物件識別碼使用的數值識別碼。

[in] pwszValueName

Null 終止 Unicode 字串的指標，其中包含要查詢之值的名稱。

[out] pdwValueType

要接收值型別之變數的指標。 透過此參數傳回的類型將是下列其中一項。

值 意義
REG_DWORD
 32 位數位。
REG_EXPAND_SZ
 Unicode 字串，其中包含環境變數的未展開參考，例如 「%PATH%」。 應用程式應該先確定字串具有終止的 Null 字元，然後再使用它。 如需字串何時沒有終止 Null 字元的詳細資訊，請參閱 RegQueryValueEx。
REG_MULTI_SZ
 Null 終止 Unicode 字串的陣列。 應用程式應該先確定陣列在使用之前，會以兩個 Null 字元正確終止。 如需陣列何時未以兩個 Null 字元終止的詳細資訊，請參閱 RegQueryValueEx。
REG_SZ
 Unicode 字串。 應用程式應該先確定字串具有終止的 Null 字元，然後再使用它。 如需字串何時沒有終止 Null 字元的詳細資訊，請參閱 RegQueryValueEx。
 

如果不需要傳回的類型， pdwValueType 參數可以是 Null 。

[out] pbValueData

緩衝區的指標，用來接收與 pwszValueName 參數相關聯的值。 緩衝區必須夠大，才能包含終止 的 Null 字元。 如果不需要傳回的資料，此參數可以是 Null 。

此參數也可以是 Null ，以尋找用於記憶體配置之緩衝區的大小。 如需詳細資訊，請參閱 擷取未知長度的資料。

[in, out] pcbValueData

DWORD的指標，指定pbValueData所指向之緩衝區的大小，以位元組為單位。

在大部分情況下，*sqlValueData 中傳回的值會包含字串中終止 Null 字元的大小。 如需不包含 Null 字元的情況相關資訊，請參閱 RegQueryValueEx的一節。

注意 處理緩衝區中傳回的資料時，應用程式必須使用傳回的資料實際大小。 實際大小可能會稍微小於輸入中指定的緩衝區大小。 (輸入時，緩衝區大小通常會指定夠大，以確保最大可能的輸出資料會符合 buffer。) On 輸出中，此參數所指向的變數會更新，以反映複製到緩衝區的實際資料大小。
 

傳回值

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

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

此函式具有下列錯誤碼。

值 描述
ERROR_MORE_DATA
 如果 pbValueData 參數指定的緩衝區不夠大，無法保存傳回的資料，函式會設定ERROR_MORE_DATA程式碼，並將所需的緩衝區大小以位元組為單位儲存到 由Data指向的變數中。

規格需求

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

另請參閱

OID 支援函式