Função SubmitNtmsOperatorRequestA (ntmsapi.h)

Artigo
11/20/2024

[Gerenciador de Armazenamento Removível não está mais disponível a partir do Windows 7 e do Windows Server 2008 R2.]

A função SubmitNtmsOperatorRequest envia uma solicitação de operador RSM.

Sintaxe

DWORD SubmitNtmsOperatorRequestA(
  [in]  HANDLE      hSession,
  [in]  DWORD       dwRequest,
  [in]  LPCSTR      lpMessage,
  [in]  LPNTMS_GUID lpArg1Id,
  [in]  LPNTMS_GUID lpArg2Id,
  [out] LPNTMS_GUID lpRequestId
);

Parâmetros

[in] hSession

Manipule para a sessão retornada pela função OpenNtmsSession.

[in] dwRequest

Tipo de solicitação de operador. Esse parâmetro pode ser um dos valores a seguir.

Valor	Significado
NTMS_OPREQ_CLEANER	O RSM envia uma solicitação de operador para inserir um limpador quando uma operação limpa é enfileirada e nenhum limpador está disponível para a unidade. O parâmetro lpArg1Id pode ser uma biblioteca ou um identificador de slot. Requer NTMS_CONTROL_ACCESS à biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_OPREQ_DEVICESERVICE	Um aplicativo ou RSM envia uma solicitação de operador para o serviço de unidade quando um dispositivo ou unidade de alteração está enfrentando problemas. O parâmetro lpArg1Id especifica o dispositivo que precisa de serviço. Esse parâmetro pode ser um identificador de unidade, biblioteca, mídia física ou iedoor. Requer NTMS_CONTROL_ACCESS à biblioteca. Windows XP: Não são necessários direitos de acesso.
NTMS_OPREQ_MESSAGE	Somente mensagem de aplicativo. Requer NTMS_USE_ACCESS para o computador. Windows XP: Não são necessários direitos de acesso.
NTMS_OPREQ_MOVEMEDIA	Um aplicativo ou RSM envia uma solicitação de operador para mover a mídia de uma biblioteca para outra para uma montagem de mídia offline ou para ejetar mídia existente para a biblioteca offline. O parâmetro lpArg1Id especifica a parte da mídia física que deve ser movida e o parâmetro lpArg2Id especifica a biblioteca de destino. Requer NTMS_CONTROL_ACCESS ao pool de mídia. Windows XP: Não são necessários direitos de acesso.
NTMS_OPREQ_NEWMEDIA	Um aplicativo ou RSM envia uma solicitação de operador para novas mídias quando nenhuma mídia está disponível. O parâmetro lpArg1Id especifica o objeto do pool de mídia e o parâmetro lpArg2Id é o identificador de biblioteca opcional ao qual adicionar o novo meio. Requer NTMS_CONTROL_ACCESS ao pool de mídia. Windows XP: Não são necessários direitos de acesso.

[in] lpMessage

Cadeia de caracteres de mensagem opcional a ser enviada ao usuário.

[in] lpArg1Id

Identificador de objeto para a solicitação do operador. Consulte as descrições dos valores no parâmetro dwRequest para obter uma descrição do tipo de objeto que deve ser passado para esse parâmetro.

[in] lpArg2Id

Identificador de objeto para a solicitação do operador. Consulte as descrições dos valores no parâmetro dwRequest para obter detalhes sobre qual tipo de objeto deve ser passado para esse parâmetro.

[out] lpRequestId

Ponteiro para um buffer que recebe o identificador da solicitação do operador que foi criada.

Valor de retorno

Essa função retorna um dos valores a seguir.

Valor	Significado
ERROR_ACCESS_DENIED	O acesso a um ou mais objetos RSM é negado.
ERROR_DATABASE_FAILURE	Falha na consulta ou atualização do banco de dados.
ERROR_INVALID_HANDLE	O valor especificado no parâmetro hSession é NULL ou não é válido.
ERROR_INVALID_PARAMETER	Um dos valores de parâmetro não é válido.
ERROR_NOT_CONNECTED	Não é possível se conectar ao serviço RSM.
ERROR_OBJECT_NOT_FOUND	Não é possível localizar o objeto de origem ou de destino.
ERROR_SUCCESS	A função foi bem-sucedida.

Observações

A função SubmitNtmsOperatorRequest envia uma solicitação de operador e retorna o status da solicitação (Atendida ou Cancelada) ou o tempo limite (se o operador não agir após a solicitação). As solicitações de operador são usadas para solicitar mídia, para solicitar que o meio especificado seja movido de uma biblioteca para outra ou para solicitar o serviço de dispositivo RSM.

O valor NTMS_OPEREQ_MESSAGE (no parâmetro dwRequest) é o tipo de solicitação usado com mais frequência pelos aplicativos. O RSM não pode usar NTMS_OPEREQ_MESSAGE. O RSM usa os outros tipos de solicitação conforme necessário.

Nota

O cabeçalho ntmsapi.h define SubmitNtmsOperatorRequest como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	ntmsapi.h
biblioteca	Ntmsapi.lib
de DLL	Ntmsapi.dll

Consulte também

AllocateNtmsMedia

CancelNtmsOperatorRequest

MountNtmsMedia

Funções de solicitação do operador

SatisfyNtmsOperatorRequest

WaitForNtmsOperatorRequest

Compartilhar via