Compartir a través de

Método IXMLHTTPRequest2::Open (msxml6.h)

  • Artículo

Inicializa una solicitud IXMLHTTPRequest2 y especifica el método, la dirección URL y la información de autenticación de la solicitud. Después de llamar a este método, debe llamar al método Send para enviar la solicitud y los datos, si los hay, al servidor.

Sintaxis

HRESULT Open(
  [in]           const WCHAR              *pwszMethod,
  [in]           const WCHAR              *pwszUrl,
  [in, optional] IXMLHTTPRequest2Callback *pStatusCallback,
  [in, optional] const WCHAR              *pwszUserName,
  [in, optional] const WCHAR              *pwszPassword,
  [in, optional] const WCHAR              *pwszProxyUserName,
  [in, optional] const WCHAR              *pwszProxyPassword
);

Parámetros

[in] pwszMethod

El método HTTP que se usa para abrir la conexión, como GET o POST. Para XMLHTTP, este parámetro no distingue mayúsculas de minúsculas.

[in] pwszUrl

Dirección URL solicitada. Debe ser una dirección URL absoluta, como "http://Myserver/Mypath/Myfile.asp".

[in, optional] pStatusCallback

Interfaz de devolución de llamada implementada por la aplicación que va a recibir eventos de devolución de llamada.

Cuando el método Send se realiza correctamente, se llama a los métodos de esta interfaz para procesar la respuesta u otros eventos.

[in, optional] pwszUserName

Nombre del usuario para la autenticación. Si este parámetro es null y el sitio requiere autenticación, Windows administrará las credenciales, incluida la visualización de una interfaz de usuario de inicio de sesión, a menos que SetProperty la deshabilite.

[in, optional] pwszPassword

Contraseña para la autenticación. Este parámetro se omite si el parámetro pwszUserName es Null o falta.

[in, optional] pwszProxyUserName

Nombre del usuario para la autenticación en el servidor proxy. Si este parámetro es una cadena nula o vacía y el sitio requiere autenticación, Windows administrará las credenciales, incluida la visualización de una interfaz de usuario de inicio de sesión, a menos que SetProperty la deshabilite.

[in, optional] pwszProxyPassword

Contraseña de autenticación en el servidor proxy. Este parámetro se omite si el parámetro pwszProxyUserName es Null o falta.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Comentarios

Aunque este método acepta las credenciales que se pasan a través del parámetro , estas credenciales no se envían automáticamente al servidor en la primera solicitud. Los parámetros pwszUserName y pwszPassword no se envían al servidor a menos que el servidor desafía al cliente las credenciales con una respuesta 401 - No autorizada.

Ejemplos

//
// Create and initialize an IXMLHTTPRequest2 object
//
hr = CoCreateInstance(CLSID_FreeThreadedXMLHTTP60,
                      NULL,
                      CLSCTX_INPROC_SERVER,
                      IID_PPV_ARGS(&spXHR));

//
//Create and initialize an IXMLHTTPRequest2Callback object
//
hr = MakeAndInitialize<CXMLHttpRequest2Callback>(&spXhrCallback);

hr = spXHR->Open(L"GET",              // Method.
                 pcwszUrl,            // Url.
                 spXhrCallback.Get(), // Callback.
                 NULL,                // Username.
                 NULL,                // Password.
                 NULL,                // Proxy username.
                 NULL);               // Proxy password.

//
//Send the GET request
//
hr = spXHR->Send(NULL, 0);

hr = spXhrCallback->WaitForComplete(&dwStatus);

Para obtener los ejemplos completos, consulte el ejemplo GET de la solicitud HTTP XML 2 y el ejemplo POST de la solicitud HTTP XML 2.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP],MSXML 6.0 y versiones posteriores
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msxml6.h

Consulte también

IXMLHTTPRequest2

IXMLHTTPRequest2Callback (Interfaz)

Send (método)