openSemaphoreW 函式 (synchapi.h)

發行項
08/26/2023

開啟現有的具名號志物件。

語法

HANDLE OpenSemaphoreW(
  [in] DWORD   dwDesiredAccess,
  [in] BOOL    bInheritHandle,
  [in] LPCWSTR lpName
);

參數

[in] dwDesiredAccess

號志物件的存取權。如果指定之物件的安全性描述元不允許呼叫進程的要求存取權，則函式會失敗。如需存取權限的清單，請參閱同步處理物件安全性和存取權限。

[in] bInheritHandle

如果此值為 TRUE，此進程所建立的進程將會繼承控制碼。否則，進程不會繼承此控制碼。

[in] lpName

要開啟的號志名稱。名稱比較會區分大小寫。

此函式可以在私用命名空間中開啟物件。如需詳細資訊，請參閱物件命名空間。

終端機服務： 名稱可以有「Global」或「Local」前置詞，以明確開啟全域或會話命名空間中的物件。名稱的其餘部分可以包含反斜線字元 (\) 以外的任何字元。如需詳細資訊，請參閱核心物件命名空間。

注意使用終端機服務會話實作快速使用者切換。要登入的第一個使用者會使用會話 0、下一個登入的使用者會使用會話 1 等等。核心物件名稱必須遵循終端機服務概述的指導方針，讓應用程式可以支援多個使用者。

傳回值

如果函式成功，則傳回值是號志物件的控制碼。

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

備註

OpenSemaphore函式可讓多個進程開啟相同號志物件的控制碼。只有在某些進程已使用 CreateSemaphore 函式建立號志時，函式才會成功。呼叫進程可以在任何需要旗號物件的控制碼的函式中使用傳回的控制碼，例如等候函式，受限於 dwDesiredAccess 參數中指定的存取限制。

使用 DuplicateHandle 函式可以複製控制碼。使用 CloseHandle 函式關閉控制碼。當進程終止時，系統會自動關閉控制碼。當最後一個控制碼關閉時，旗號物件就會終結。

規格需求


最低支援的用戶端	Windows XP [傳統型應用程式 \|UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 \|UWP 應用程式]
目標平台	Windows
標頭	synchapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll