Partager via

HttpSetRequestProperty, fonction (http.h)

  • Article

La fonction HttpSetRequestProperty définit une nouvelle propriété ou modifie une propriété existante sur la requête spécifiée.

Syntaxe

HTTPAPI_LINKAGE ULONG HttpSetRequestProperty(
  [in] HANDLE                RequestQueueHandle,
  [in] HTTP_OPAQUE_ID        Id,
  [in] HTTP_REQUEST_PROPERTY PropertyId,
  [in] PVOID                 Input,
  [in] ULONG                 InputPropertySize,
  [in] LPOVERLAPPED          Overlapped
);

Paramètres

[in] RequestQueueHandle

Handle de la file d’attente de requêtes sur laquelle la demande a été reçue. Une file d’attente de requêtes est créée et son handle est retourné par un appel à la fonction HttpCreateRequestQueue .

[in] Id

ID opaque de la demande. Cet ID se trouve dans le membre RequestId de la structure HTTP_REQUEST retournée par HttpReceiveHttpRequest.

[in] PropertyId

Membre du HTTP_REQUEST_PROPERTY énumération décrivant le type de propriété défini. Il doit s’agir de l’un des éléments suivants :

| Propriété | Signification | | HttpRequestPropertyStreamError | Définit une erreur de flux sur la demande. |

[in] Input

Pointeur vers la mémoire tampon qui contient les informations de propriété.

Elle doit pointer vers l’un des types d’informations de propriété suivants en fonction de la propriété définie.

| Propriété | Type de configuration | | HttpRequestPropertyStreamError | HTTP_REQUEST_PROPERTY_STREAM_ERROR structure |

[in] InputPropertySize

Longueur, en octets, de la mémoire tampon pointée par le paramètre Input .

[in] Overlapped

Pour les appels asynchrones, définissez pOverlapped pour qu’il pointe vers une structure CHEVAUCHEMENT . pour les appels synchrones, définissez-le sur NULL.

Un appel synchrone se bloque jusqu’à ce que l’opération soit terminée, tandis qu’un appel asynchrone retourne immédiatement ERROR_IO_PENDING et l’application appelante utilise alors les ports d’achèvement GetOverlappedResult ou E/S pour déterminer quand l’opération est terminée. Pour plus d’informations sur l’utilisation des structures OVERLAPPED pour la synchronisation, consultez Synchronisation et entrée et sortie superposées.

Valeur retournée

Si la fonction réussit, elle retourne ERROR_SUCCESS.

Si la fonction échoue, elle retourne un code d’erreur système.

Configuration requise

   
Plateforme cible Windows
En-tête http.h
Bibliothèque Httpapi.lib
DLL Httpapi.dll

Voir aussi

HttpSetRequestQueueProperty