CHttpFilterContext::ServerSupportFunction

BOOL ServerSupportFunction(enum SF_REQ_TYPE sfReq, PVOID pvData, LPDWORD lpdwSize, LPDDWORD lpdwDataType )

Valeur de retour

Différent de zéro en cas de succès, sinon 0.

Paramètres

sfReq

Type de requête du serveur. Consultez la section Remarques pour une liste des valeurs possibles.

pvData

Un pointeur vers une chaîne terminée par zéro. Sa valeur est spécifique à l'extension sfReq . Lorsqu'il est utilisé avec SF_REQ_SEND_RESPONSE_HEADER, c'est une chaîne de statut facultatif, terminée par null (par exemple, « 401 accès refusé ») ou NULL pour la réponse par défaut de "200 OK". Lorsqu'il est utilisé avec SF_REQ_ADD_HEADERS_ON_DENIAL, c'est une chaîne terminée par null pointant sur une ou plusieurs lignes d'en-tête avec cessation "\r\n".

lpdwSize

nbsp ;Chaîne terminée par null. Sa valeur est spécifique à l'extension. Lorsqu'il est utilisé avec SF_REQ_SE&ND_RESPONSE_HEADER, c'est une chaîne terminée par null pointant vers des données facultatives être annexé et la valeur de l'en-tête. Si NULL, l'en-tête sera terminé par une ligne vide. Lorsqu'il est utilisé avec SF_REQ_ADD_HEADERS_ON_DENIAL, c'est la taille en octets pour la prochaine lecture.

lpdwDataType

Une chaîne terminée par null pointer aux en-têtes facultatifs ou aux données d'être annexés et envoyé avec l'en-tête. Ifnbsp ; &NULL, l'en-tête sera mis fin par une paire de "\r\n".

Remarques

Appelez cette fonction membre pour étendre l'API ISA.

La valeur Extension de serveur HTTP, représentée par sfReq, peut être l'une des opérations suivantes:

SF_REQ_SEND_RESPONSE_HEADER

En-tête de réponse serveur envoie un HTTP complet y compris le statut, version du serveur, temps de message et version MIME (Multipurpose Internet Mail Extension). Extensions serveur devraient ajouter d'autres informations à la fin, comme le type de contenu, Content-length et ainsi de suite, suivi d'un supplément « \r\n ».

SF_REQ_ADD_HEADERS_ON_DENIAL

Si le serveur rejette la requête HTTP, ajoutez les en-têtes spécifiés à la réponse d'erreur serveur. Cela permet à un filtre d'authentification annoncer ses services sans filtrage de chaque demande. Les en-têtes seront généralement des en-têtes WWW-authentifier avec les schémas d'authentification personnalisés, mais aucune restriction n'est placée sur les en-têtes peuvent être spécifiées.

SF_REQ_SET_NEXT_READ_SIZE

Utilisé uniquement par les filtres de données brutes qui renvoient des SF_STATUS_READ_NEXT.

Aperçu CHttpFilterContext |nbsp ; Membres de la classe | Graphique de la hiérarchie

Index