Função GUIDFromString

[GUIDFromString está disponível por meio do Windows XP com Service Pack 2 (SP2) ou Windows Vista. Ele pode estar alterado ou indisponível em versões subsequentes. Os aplicativos devem usar CLSIDFromString ou IIDFromString no lugar dessa função.]

Converte uma cadeia de caracteres em um GUID.

Sintaxe

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

Parâmetros

psz [in]

Tipo: LPCTSTR

Um ponteiro para a cadeia de caracteres terminada em nulo a ser convertida. A cadeia de caracteres deve estar no seguinte formato:

{00000000-0000-0000-0000-000000000000}

pguid [out]

Tipo: LPGUID

Ponteiro para um buffer para receber o GUID quando esse método retornar.

Valor retornado

Tipo: BOOL

TRUE se o GUID foi criado com êxito; caso contrário, FALSE.

Comentários

Essa função não é declarada em um cabeçalho ou exportada pelo nome de um arquivo .dll. Ele deve ser carregado de Shell32.dll como ordinal 703 para GUIDFromStringA e ordinal 704 para GUIDFromStringW.

Ele também pode ser acessado de Shlwapi.dll como ordinal 269 para GUIDFromStringA e ordinal 270 para GUIDFromStringW.

Requisitos