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