Função CLSIDFromString (combaseapi.h)

Converte uma cadeia de caracteres gerada pela função StringFromCLSID de volta no CLSID original.

Sintaxe

HRESULT CLSIDFromString(
  [in]  LPCOLESTR lpsz,
  [out] LPCLSID   pclsid
);

Parâmetros

[in] lpsz

A representação de cadeia de caracteres terminada zero do CLSID ou progID ou NULL.

[out] pclsid

Um ponteiro para o CLSID.

Retornar valor

Essa função pode retornar o valor retornado padrão E_INVALIDARG, bem como os valores a seguir.

Código de retorno	Descrição
NOERROR	O CLSID foi obtido com êxito.
CO_E_CLASSSTRING	A cadeia de caracteres de classe foi formatada incorretamente.

Comentários

O formato CLSID é {xxxxxxxx-xxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}.

Passar o ProgID resulta em salvar CLSID associado em pclsid. Passar NULL resulta em GUID_NULL.

Requisitos

Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	combaseapi.h (inclua Objbase.h)
Biblioteca	Ole32.lib
DLL	Ole32.dll

Confira também

CLSIDFromProgID

StringFromCLSID