GUIDFromString 函式

[GUIDFromString 可透過 Windows XP 搭配 Service Pack 2 (SP2) 或 Windows Vista 取得。 後續版本可能會改變或無法使用。 應用程式應該使用 CLSIDFromStringIIDFromString 取代此函式。

將字串轉換成 GUID。

語法

BOOL GUIDFromString(
  _In_  LPCTSTR psz,
  _Out_ LPGUID  pguid
);

參數

psz [in]

類型: LPCTSTR

要轉換之 Null 終止字串的指標。 字串的格式應如下:

{00000000-0000-0000-0000-000000000000}

pguid [out]

類型: LPGUID

當這個方法傳回時,要接收 GUID 之緩衝區的指標。

傳回值

類型: BOOL

如果 已成功建立 GUID,則為 TRUE;否則為 FALSE

備註

此函式不會在標頭中宣告,或依名稱從.dll檔案匯出。 它必須從 GUIDFromStringA 的序數 703 載入Shell32.dll,而 GUIDFromStringW的序數 704 則為序數 704。

它也可以從 guiDFromStringA 的序數 269 從 Shlwapi.dll存取,而 GUIDFromStringW的序數 270 則為 。

規格需求

需求
最低支援的用戶端
Windows XP [僅限傳統型應用程式]
最低支援的伺服器
Windows 2000 Server [僅限傳統型應用程式]
DLL
Shell32.dll
Unicode 與 ANSI 名稱
GUIDFromStringW (Unicode) 和 GUIDFromStringA (ANSI)