Função WinHttpOpenRequest (winhttp.h)

A função WinHttpOpenRequest cria um identificador de solicitação HTTP.

Sintaxe

WINHTTPAPI HINTERNET WinHttpOpenRequest(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   pwszVerb,
  [in] LPCWSTR   pwszObjectName,
  [in] LPCWSTR   pwszVersion,
  [in] LPCWSTR   pwszReferrer,
  [in] LPCWSTR   *ppwszAcceptTypes,
  [in] DWORD     dwFlags
);

Parâmetros

[in] hConnect

Identificador de conexão HINTERNET para uma sessão HTTP retornada por WinHttpConnect.

[in] pwszVerb

Ponteiro para uma cadeia de caracteres que contém o verbo HTTP a ser usado na solicitação. Se esse parâmetro for NULL, a função usará GET como o verbo HTTP. Nota Essa cadeia de caracteres deve ser toda maiúscula. Muitos servidores tratam os verbos HTTP como diferenciadores de maiúsculas e minúsculas e as RFCs (Solicitações de Comentários) da IETF (Internet Engineering Task Force) soletram esses verbos usando apenas caracteres maiúsculos.

[in] pwszObjectName

Ponteiro para uma cadeia de caracteres que contém o nome do recurso de destino do verbo HTTP especificado. Geralmente, esse é um nome de arquivo, um módulo executável ou um especificador de pesquisa.

[in] pwszVersion

Ponteiro para uma cadeia de caracteres que contém a versão HTTP. Se esse parâmetro for NULL, a função usará HTTP/1.1.

[in] pwszReferrer

Ponteiro para uma cadeia de caracteres que especifica a URL do documento do qual a URL na solicitação pwszObjectName foi obtida. Se esse parâmetro for definido como WINHTTP_NO_REFERER, nenhum documento de referência será especificado.

[in] ppwszAcceptTypes

Ponteiro para uma matriz terminada em nulo de ponteiros de cadeia de caracteres que especifica os tipos de mídia aceitos pelo cliente. Se esse parâmetro for definido como WINHTTP_DEFAULT_ACCEPT_TYPES, nenhum tipo será aceito pelo cliente. Normalmente, os servidores lidam com a falta de tipos aceitos como indicação de que o cliente aceita apenas documentos do tipo "text/*"; ou seja, somente documentos de texto— sem imagens ou outros arquivos binários. Para obter uma lista de tipos de mídia válidos, consulte Tipos de mídia definidos pela IANA em http://www.iana.org/assignments/media-types/.

[in] dwFlags

Valor inteiro longo sem sinal que contém os valores do sinalizador da Internet. Esse valor pode ser um ou mais dos seguintes:

Retornar valor

Retornará um identificador de solicitação HTTP válido se tiver êxito ou NULL , caso contrário. Para obter informações de erro estendidas, chame GetLastError. Entre os códigos de erro retornados estão os seguintes.

Comentários

O valor retornado indica êxito ou falha. Para obter informações de erro estendidas, chame GetLastError.

A função WinHttpOpenRequest cria um novo identificador de solicitação HTTP e armazena os parâmetros especificados nesse identificador. Um identificador de solicitação HTTP contém uma solicitação para enviar a um servidor HTTP e contém todos os cabeçalhos RFC822/MIME/HTTP a serem enviados como parte da solicitação.

Se pwszVerb estiver definido como "HEAD", o cabeçalho Content-Length será ignorado.

Se uma função de retorno de chamada status tiver sido instalada com WinHttpSetStatusCallback, uma notificação de WINHTTP_CALLBACK_STATUS_HANDLE_CREATED indicará que WinHttpOpenRequest criou um identificador de solicitação.

Depois que o aplicativo de chamada terminar de usar o identificador HINTERNET retornado por WinHttpOpenRequest, ele deverá ser fechado usando a função WinHttpCloseHandle .

Exemplos

Este exemplo mostra como obter um identificador HINTERNET , abrir uma sessão HTTP, criar um cabeçalho de solicitação e enviar esse cabeçalho para o servidor.

    BOOL  bResults = FALSE;
    HINTERNET hSession = NULL,
              hConnect = NULL,
              hRequest = NULL;

    // Use WinHttpOpen to obtain a session handle.
    hSession = WinHttpOpen(  L"A WinHTTP Example Program/1.0", 
                             WINHTTP_ACCESS_TYPE_DEFAULT_PROXY,
                             WINHTTP_NO_PROXY_NAME, 
                             WINHTTP_NO_PROXY_BYPASS, 0);

    // Specify an HTTP server.
    if (hSession)
        hConnect = WinHttpConnect( hSession, L"www.wingtiptoys.com",
                                   INTERNET_DEFAULT_HTTP_PORT, 0);

    // Create an HTTP Request handle.
    if (hConnect)
        hRequest = WinHttpOpenRequest( hConnect, L"PUT", 
                                       L"/writetst.txt", 
                                       NULL, WINHTTP_NO_REFERER, 
                                       WINHTTP_DEFAULT_ACCEPT_TYPES,
                                       0);

    // Send a Request.
    if (hRequest) 
        bResults = WinHttpSendRequest( hRequest, 
                                       WINHTTP_NO_ADDITIONAL_HEADERS,
                                       0, WINHTTP_NO_REQUEST_DATA, 0, 
                                       0, 0);

    // PLACE ADDITIONAL CODE HERE.

    // Report any errors.
    if (!bResults)
        printf( "Error %d has occurred.\n", GetLastError());

    // Close any open handles.
    if (hRequest) WinHttpCloseHandle(hRequest);
    if (hConnect) WinHttpCloseHandle(hConnect);
    if (hSession) WinHttpCloseHandle(hSession);

Requisitos

Confira também

Sobre os Serviços HTTP do Microsoft Windows (WinHTTP)

Versões do WinHTTP

WinHttpConnect

WinHttpOpen