[GUIDFromString は、Windows XP と Service Pack 2 (SP2) または Windows Vista を使用して使用できます。 後続のバージョンでは変更または使用できない可能性があります。 アプリケーションでは、この関数の代わりに CLSIDFromString または IIDFromString を使用する必要があります。]
文字列を 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、GUIDFromStringW の場合は序数 704 として、Shell32.dllから読み込む必要があります。
また、 GUIDFromStringA の場合は序数 269、GUIDFromStringW の場合は序数 270 として、 Shlwapi.dllからアクセスすることもできます。
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| [DLL] |
|
| Unicode 名と ANSI 名 |
GUIDFromStringW (Unicode) と GUIDFromStringA (ANSI) |