Функция GUIDFromString

  • Статья

[GUIDFromString доступен в Windows XP с пакетом обновления 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

ЗНАЧЕНИЕ TRUE , если GUID был успешно создан; в противном случае — FALSE.

Комментарии

Эта функция не объявляется в заголовке и не экспортируется по имени из файла .dll. Он должен быть загружен из Shell32.dll как порядковый номер 703 для GUIDFromStringA и порядковый номер 704 для GUIDFromStringW.

Доступ к нему также можно получить из Shlwapi.dll как порядковый номер 269 для GUIDFromStringA и порядковый номер 270 для GUIDFromStringW.

Требования

Требование Значение
Минимальная версия клиента
 Windows XP [только классические приложения]
Минимальная версия сервера
 Windows 2000 Server [только классические приложения]
DLL
Shell32.dll
Имя в кодировке Юникод и ANSI
 GUIDFromStringW (Юникод) и GUIDFromStringA (ANSI)