共用方式為

LookupPrivilegeValueA 函式 （winbase.h）

  • 發行項

LookupPrivilegeValue 函式會擷取指定系統上用來在本機代表指定許可權名稱的 本機唯一標識符 （LUID）。

語法

BOOL LookupPrivilegeValueA(
  [in, optional] LPCSTR lpSystemName,
  [in]           LPCSTR lpName,
  [out]          PLUID  lpLuid
);

參數

[in, optional] lpSystemName

Null 終止字串的指標，指定擷取許可權名稱的系統名稱。 如果指定 Null 字串，函式會嘗試在本機系統上尋找許可權名稱。

[in] lpName

Null 終止字串的指標，指定許可權的名稱，如 Winnt.h 頭檔中所定義。 例如，此參數可以指定常數、SE_SECURITY_NAME或其對應的字串串 “SeSecurityPrivilege”。

[out] lpLuid

變數的指標，可接收 LUID，而該變數在 lpSystemName 參數所指定的系統上已知許可權。

傳回值

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

如果函式失敗，則會傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

言論

LookupPrivilegeValue 函式僅支援 Winnt.h 的 [定義許可權] 區段中指定的許可權。 如需值清單，請參閱 Privilege Constants。

例子

如需使用此函式的範例，請參閱 啟用和停用權限。

注意

winbase.h 標頭會根據 UNICODE 預處理器常數的定義，將 LookupPrivilegeValue 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows XP [傳統型應用程式 |UWP 應用程式]
支援的最低伺服器 Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平臺 窗戶
標頭 winbase.h （包括 Windows.h）
連結庫 Advapi32.lib
DLL Advapi32.dll

另請參閱

訪問控制

基本訪問控制函式

LookupPrivilegeDisplayName

LookupPrivilegeName