Função GetNtmsUIOptionsW (ntmsapi.h)
[O Gerenciador de Armazenamento Removível não está mais disponível desde o Windows 7 e o Windows Server 2008 R2.]
A função GetNtmsUIOptions obtém a lista de nomes de computador para os quais o tipo especificado de interface do usuário está sendo direcionado para o objeto fornecido. Uma chamada para GetNtmsUIOptions retorna a lista de destinos para a instância determinada pelos parâmetros lpObjectId e dwType .
Se não houver destinos na lista para a instância especificada, a função retornará ERROR_SUCCESS juntamente com um comprimento de lista de zero.
Sintaxe
DWORD GetNtmsUIOptionsW(
[in] HANDLE hSession,
[in] const LPNTMS_GUID lpObjectId,
[in] DWORD dwType,
[out] LPWSTR lpszDestination,
[in, out] LPDWORD lpdwBufSize
);
Parâmetros
[in] hSession
Identificador para a sessão retornada pela função OpenNtmsSession .
[in] lpObjectId
Identificador exclusivo do objeto cuja interface do usuário está sendo redirecionada. O objeto deve ser um contêiner que pode ser uma origem para eventos. O objeto pode ser um aplicativo (uma solicitação de montagem disparada pelo aplicativo), uma biblioteca (uma solicitação de abertura de porta em resposta a uma ejeção) ou um computador (toda a interface do usuário pertencente ao computador).
Para especificar o contêiner do computador, defina o ponteiro lpObjectId para apontar para um buffer com o GUID do objeto de computador do Gerenciador de Armazenamento Removível. Para especificar uma biblioteca específica, defina-a para apontar para um buffer com o GUID da biblioteca. Para especificar um aplicativo, passe um ponteiro NULL . A identidade do aplicativo é determinada pela sessão usada em hSession. Observe que um aplicativo pode ter várias sessões abertas simultaneamente. Nesse caso, o conjunto de valores se aplica somente à sessão hSession .
[in] dwType
Esse parâmetro pode ter um dos valores a seguir.
[out] lpszDestination
Várias cadeias de caracteres que retornam os nomes dos computadores para os quais a interface do usuário está sendo redirecionada. Esse parâmetro não pode ser NULL.
[in, out] lpdwBufSize
Tamanho da cadeia de caracteres de destino, em TCHARs.
Retornar valor
Essa função retorna um dos valores a seguir.
Valor | Significado |
---|---|
|
O acesso a um ou mais objetos RSM foi negado. |
|
O tamanho do buffer especificado por lpdwSize é muito pequeno para os destinos encontrados. A função retorna o tamanho real em lpdwSize. |
|
O identificador de sessão está ausente ou não é válido. |
|
O parâmetro lpdwSize ou lpszDestination é NULL ou lpObjectId não é um contêiner válido ou dwType não é um dos três valores válidos. |
|
Ocorreu uma falha de alocação durante o processamento. |
|
O GUID especificado por lpObjectId não é o GUID de nenhum objeto de computador ou biblioteca no banco de dados. |
|
A função foi bem-sucedida. |
Comentários
Uma chamada para GetNtmsUIOptions retorna uma lista de destinos para uma instância específica determinada pelos parâmetros lpObjectId e dwType .
NTMS_UITYPE_INFO | NTMS_UITYPE_REQ | NTMS_UITYPE_ERR | |
---|---|---|---|
Aplicativo | Exiba a interface do usuário de progresso do item de trabalho para itens de trabalho gerados por este aplicativo. | Exibe a interface do usuário da solicitação do operador para solicitações de operador geradas por ações executadas por esse aplicativo. | Indefinido. Os aplicativos não podem causar esse tipo de evento de erro. |
Biblioteca | Exiba a interface do usuário de progresso do item de trabalho para itens de trabalho associados a essa biblioteca. | Exibe a interface do usuário para solicitações associadas a essa biblioteca. | Exiba a interface do usuário para erros associados a essa biblioteca. |
Computador | Exiba a interface do usuário informativa nesta instância do RSM em execução neste computador. | Exiba uma interface do usuário do tipo solicitação nesta instância do RSM. | Exibe a interface do usuário do tipo erro nesta instância do RSM. |
Observação
O cabeçalho ntmsapi.h define GetNtmsUIOptions como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
Requisito | Valor |
---|---|
Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
Plataforma de Destino | Windows |
Cabeçalho | ntmsapi.h |
Biblioteca | Ntmsapi.lib |
DLL | Ntmsapi.dll |