StringFromCLSID
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/8/2008
Essa função converte um identificador classe em um seqüência de caracteres de caracteres imprimíveis. Classe diferentes identificadores sempre converter para seqüências de caracteres diferentes.
Syntax
WINOLEAPI StringFromCLSID(
REFCLSID rclsid,
LPOLESTR* ppsz
);
Parameters
- rclsid
[no] Identificador de classe a ser convertido.
- ppsz
[out] Endereço do LPOLESTR ponteiro variável que recebe um ponteiro para o seqüência de caracteres NULL-Terminated resultante.
Return Value
S_OK indica que o identificador de classe foi convertido e retornado com êxito. O padrão também é E_OUTOFMEMORY valor de retorno com suporte.
Remarks
O StringFromCLSID função chamadas a StringFromGUID2 função para converter um identificador exclusivo (GUID) em um seqüência de caracteres de caracteres imprimíveis.
O chamador é responsável por liberar a memória alocada para o seqüência de caracteres por chamado CoTaskMemFree.
Passando para esta função qualquer inválido e, em algumas circunstâncias, NULL ponteiros resulta em terminação inesperada do aplicativo.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |