StringFromGUID2

9/8/2008

Essa função converte um identificador exclusivo (GUID) em um seqüência de caracteres de caracteres imprimíveis.

Syntax

StringFromGUID2(
  REFGUID rguid, 
  LPOLESTR lpsz, 
  int cbMax
); 

Parameters

• rguid
  [no] Interface identificador a ser convertido.

• lpsz
  [out] Ponteiro longo para o seqüência de caracteres NULL-Terminated resultante no retorno.

• cbMax
  [no] Contagem de caracteres da seqüência de caracteres indicada por lpsz.

Return Value

Nonzero indica o número de caracteres de seqüência de caracteres retornada, incluindo a caractere nulo de terminação. Zero indica que a reserva é muito pequena para seqüência de caracteres retornado.

Remarks

O seqüência de caracteres que a lpsz parâmetro recebe tem um formato como que o seguinte exemplo:

{c200e360-38c5–11ce-ae62-08002b2b79ef}

Onde a interromper campos sucessivas de GUID para a forma DWORD-WORD-WORD-WORD-WORD.DWORD cobrindo a 128-bit GUID. O seqüência de caracteres incluem delimitador chaves. Essas são uma convenção OLE.

Passando para esta função qualquer inválido e, em algumas circunstâncias, NULL ponteiros resultam 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