Método ITocEntry::GetTitle (wmcodecdsp.h)

O método GetTitle recupera o título, definido por uma chamada anterior para SetTitle, da entrada.

Sintaxe

HRESULT GetTitle(
  [in, out] WORD   *pwTitleSize,
  [out]     LPWSTR pwszTitle
);

Parâmetros

[in, out] pwTitleSize

Se pwszTitle for NULL, esse será um parâmetro de saída que recebe o tamanho, em caracteres largos, do buffer necessário para receber o título. Se pwszTitle não for NULL, esse será um parâmetro de entrada que especifica o tamanho, em caracteres largos, do buffer alocado pelo chamador apontado por pwszTitle.

[out] pwszTitle

NULL ou um ponteiro para um buffer alocado pelo chamador que, após a conclusão bem-sucedida, recebe o título. O título é encerrado em nulo.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
MF_E_BUFFERTOOSMALL	O método retornará esse código de erro se pwszTitle não for NULL e o título, incluindo seu terminador NULL, for maior que o tamanho especificado por pwTitleSize. Nesse caso, pwTitleSize serve como um parâmetro de saída e recebe o tamanho do buffer necessário.

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	wmcodecdsp.h
DLL	Wmvdspa.dll

Confira também

ITocEntry

Settitle