função MI_Context_PromptUser (mi.h)

Envia uma mensagem de prompt para o cliente consultando se deseja continuar a operação ou cancelá-la.

Sintaxe

MI_INLINE MI_Result MI_INLINE_CALL MI_Context_PromptUser(
  [in]  MI_Context    *context,
  [in]  const MI_Char *message,
        MI_PromptType promptType,
  [out] MI_Boolean    *flag
);

Parâmetros

[in] context

Contexto da solicitação.

[in] message

Uma cadeia de caracteres terminada em nulo que representa a mensagem de prompt para o cliente.

promptType

Tipo de prompt conforme definido por MI_PromptType. O provedor deve tentar usar a localidade especificada pelo cliente (recuperada por meio da função MI_Context_GetLocale ).

[out] flag

Valor retornado do cliente. MI_TRUE indica que o processo deve continuar. MI_FALSE indica que o processo deve parar e o provedor deve postar algum erro final para dizer que a operação foi cancelada.

Retornar valor

Um valor da enumeração MI_Result que especifica o código de retorno da função. Esse pode ser um dos códigos a seguir.

Comentários

Se o cliente tiver um resultado automático especificado, a mensagem será relatada, mas a função não aguardará. Se o cliente não estiver interessado nessa função, a função retornará imediatamente com a resposta padrão. Caso contrário, a função não retornará até que o cliente responda ao prompt.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Windows
Cabeçalho	mi.h
Redistribuível	Windows Management Framework 3.0 no Windows Server 2008 R2 com SP1, Windows 7 com SP1 e Windows Server 2008 com SP2

Confira também

MI_Context

MI_Context_GetLocale

MI_Context_ShouldContinue

MI_Context_ShouldProcess

MI_PromptType