Método CItemIDFactory::CreateItemID (shidfact.h)

  • Artigo

Cria um ItemID com base nos dados fornecidos.

Sintaxe

HRESULT CreateItemID(
  [in, optional]      const T        *pinner,
  [in, out, optional] IPropertyStore *pps,
  [out]               PITEMID_CHILD  *ppidl
);

Parâmetros

[in, optional] pinner

Um ponteiro para a estrutura do cliente que deve ser copiada.

[in, out, optional] pps

Um ponteiro para um IPropertyStore que será serializado no ItemID.

[out] ppidl

Quando esse método retorna, contém um ponteiro para o ItemID que contém os dados do cliente e os dados IPropertyStore .

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

O tamanho dos dados fornecidos pelo usuário deve ser igual a sizeof(T). Não use structs com membros de matriz/cadeia de caracteres alocados variavelmente. O struct também deve seguir o SHITEMID padrão para persistência e portabilidade.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shidfact.h

Confira também

CItemIDFactory

Ipropertystore

SHITEMID