Método IWMDMOperation::GetObjectName (mswmdm.h)

O Gerenciador de Dispositivos do Windows Media chama GetObjectName antes que um objeto seja gravado no dispositivo para saber o que ele deve ser nomeado no dispositivo.

Sintaxe

HRESULT GetObjectName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Parâmetros

[out] pwszName

Ponteiro para uma cadeia de caracteres largos terminada em nulo que especifica o nome do objeto. O nome deve incluir uma extensão de arquivo, se necessário. O Windows Media Gerenciador de Dispositivos aloca e libera esse buffer. nMaxChars especifica o número máximo de caracteres, incluindo o caractere nulo de terminação.

[in] nMaxChars

Inteiro que especifica o número de caracteres em pwszName, incluindo o caractere nulo de terminação.

Retornar valor

O aplicativo deve retornar um dos seguintes valores HRESULT .

Código de retorno	Descrição
S_OK	A operação de leitura deve continuar.
WMDM_E_USER_CANCELLED	A operação de leitura deve ser cancelada sem término.
E_FAIL	Ocorreu um erro não especificado e a operação de leitura deve ser cancelada sem término.

Comentários

Esse método só será chamado se o aplicativo não especificar o nome como um parâmetro no método Insert .

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	mswmdm.h
Biblioteca	Mssachlp.lib

Confira também

Manipulando transferências de arquivos manualmente

IWMDMOperation Interface

IWMDMOperation::SetObjectName