Compartilhar via


Método IVdsServiceIscsi::GetInitiatorName (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Retorna o nome iSCSI do serviço iniciador local.

Sintaxe

HRESULT GetInitiatorName(
  [out] LPWSTR *ppwszIscsiName
);

Parâmetros

[out] ppwszIscsiName

O endereço de um ponteiro para uma cadeia de caracteres. O VDS colocará um ponteiro para uma cadeia de caracteres inicializada neste local. Os chamadores devem liberar a cadeia de caracteres usando a função CoTaskMemFree .

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Código de retorno Descrição
S_OK
O nome foi retornado com êxito.
E_POINTER
O parâmetro ppwszIscsiName não é um ponteiro válido.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib
Redistribuível VDS 1.1

Confira também

IVdsServiceIscsi