Método IXMLHTTPRequest2::Open (msxml6.h)
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 |