Função CLSIDFromString (combaseapi.h)

  • Artigo

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