Compartilhar via


Função CreateFormatEnumerator (urlmon.h)

Cria um objeto que implementa IEnumFORMATETC em uma matriz estática de estruturas FORMATETC .

Sintaxe

HRESULT CreateFormatEnumerator(
  [in]  UINT           cfmtetc,
  [in]  FORMATETC      *rgfmtetc,
  [out] IEnumFORMATETC **ppenumfmtetc
);

Parâmetros

[in] cfmtetc

Número de estruturas FORMATETC na matriz estática especificada pelo parâmetro rgfmtetc . O parâmetro cfmtetc não pode ser zero.

[in] rgfmtetc

Ponteiro para uma matriz estática de estruturas FORMATETC .

[out] ppenumfmtetc

Endereço da variável de ponteiro IEnumFORMATETC que recebe o ponteiro de interface para o objeto enumerador.

Valor retornado

Essa função retorna S_OK em caso de êxito. Outros valores retornados possíveis incluem o seguinte.

Código de retorno Descrição
E_INVALIDARG
Um ou mais parâmetros são inválidos.

Comentários

A função CreateFormatEnumerator cria um objeto enumerador que implementa IEnumFORMATETC em uma matriz estática de estruturas FORMATETC . O parâmetro cfmtetc especifica o número dessas estruturas. Com o ponteiro , você pode chamar os métodos de enumeração padrão para enumerar as estruturas.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho urlmon.h
Biblioteca Urlmon.lib
DLL Urlmon.dll