ORQueryInfoKey 函式
擷取離線登錄區中指定登錄機碼的相關資訊。
語法
DWORD ORQueryInfoKey(
_In_ ORHKEY Handle,
_Out_opt_ PWSTR lpClass,
_Inout_opt_ PDWORD lpcClass,
_Out_opt_ PDWORD lpcSubKeys,
_Out_opt_ PDWORD lpcMaxSubKeyLen,
_Out_opt_ PDWORD lpcMaxClassLen,
_Out_opt_ PDWORD lpcValues,
_Out_opt_ PDWORD lpcMaxValueNameLen,
_Out_opt_ PDWORD lpcMaxValueLen,
_Out_opt_ PDWORD lpcbSecurityDescriptor,
_Out_opt_ PFILETIME lpftLastWriteTime
);
參數
-
處理 [in]
-
離線登錄區中開啟登錄機碼的控制碼。
-
lpClass [out， optional]
-
接收索引鍵類別之緩衝區的指標。 此參數可以是 Null。
-
lpcClass [in， out， optional]
-
變數的指標，指定 lpClass 參數所指向的緩衝區大小，以字元為單位。
大小應該包含終止的 Null 字元。 當函式傳回時，此變數會包含儲存在緩衝區中的類別字串大小。 傳回的計數不包含終止的 Null 字元。 如果緩衝區不夠大，函式會傳回ERROR_MORE_DATA，而變數包含字串的大小，以字元為單位，而不會計算終止的 Null 字元。
如果 lpClass 為 Null， lpcClass 可以是 Null。
如果 lpClass 參數是有效的位址，但 lpcClass 參數不是 (例如，如果 lpcClass 參數是 Null) 則函式會傳回ERROR_INVALID_PARAMETER。
-
lpcSubKeys [out， optional]
-
變數的指標，接收指定索引鍵所包含的子機碼數目。 此參數可以是 Null。
-
lpcMaxSubKeyLen [out， optional]
-
在 Unicode 字元中，接收索引鍵子機碼大小且名稱最長的變數指標，不包含終止的 Null 字元。 此參數可以是 Null。
-
lpcMaxClassLen [out， optional]
-
變數的指標，可接收 Unicode 字元中指定子機碼類別的最長字串大小。 傳回的計數不包含終止的 Null 字元。 此參數可以是 Null。
-
lpcValues [out， optional]
-
變數的指標，可接收與索引鍵相關聯的值數目。 此參數可以是 Null。
-
lpcMaxValueNameLen [out， 選擇性]
-
以 Unicode 字元接收索引鍵最長值名稱大小的變數指標。 大小不包含終止的 Null 字元。 此參數可以是 Null。
-
lpcMaxValueLen [out， optional]
-
變數的指標，可接收索引鍵值之間最長資料元件的大小，以位元組為單位。 此參數可以是 Null。
-
lSecurityDescriptor [out， 選擇性]
-
接收金鑰安全描述元大小的變數指標，以位元組為單位。 此參數可以是 Null。
-
lpftLastWriteTime [out， optional]
-
接收上次寫入時間之 FILETIME 結構的指標。 此參數可以是 Null。
函式會設定 FILETIME 結構的成員，以指出上次修改索引鍵或其任何值專案的時間。
傳回值
如果函式成功，傳回值會ERROR_SUCCESS。
如果函式失敗，傳回值是 Winerror.h 中定義的非零錯誤碼。 您可以使用 FormatMessage 函式搭配 FORMAT_MESSAGE_FROM_SYSTEM 旗標，以取得錯誤的一般描述。
如果 lpClass 緩衝區太小而無法接收類別的名稱，函式會傳回ERROR_MORE_DATA。
規格需求
| 需求 | 值 |
|---|---|
| 可轉散發套件 |
Windows 離線登錄程式庫 1.0 版或更新版本 |
| 標頭 |
|
| DLL |
|
另請參閱