Método IVdsIscsiTarget::GetConnectedInitiators (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 a lista de nomes iSCSI dos iniciadores atualmente conectados ao destino.
Sintaxe
HRESULT GetConnectedInitiators(
[out] LPWSTR **pppwszInitiatorList,
[out] LONG *plNumberOfInitiators
);
Parâmetros
[out] pppwszInitiatorList
O endereço de uma variável que recebe uma matriz de cadeias de caracteres que contém os nomes iSCSI dos iniciadores atualmente conectados ao destino. Os chamadores devem liberar cada cadeia de caracteres nessa matriz, bem como a própria matriz, usando a função CoTaskMemFree .
[out] plNumberOfInitiators
Um ponteiro para o número de cadeias de caracteres retornadas em pppwszInitiatorList.
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.
Valor/código retornado | Descrição |
---|---|
|
A lista de iniciadores conectados foi retornada com êxito. |
|
Outra operação está em andamento; essa operação não pode continuar até que as operações anteriores sejam concluídas. |
|
O cache do provedor está corrompido. Isso indica um problema de software ou comunicação dentro de um provedor que armazena em cache informações sobre os dispositivos anexados. O chamador pode usar o método IVdsHwProvider::Reenumerate seguido pelo método IVdsHwProvider::Refresh para restaurar o cache. |
|
O objeto de destino não está mais presente. |
Requisitos
Requisito | Valor |
---|---|
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 |