Aracılığıyla paylaş


CHttpFile::AddRequestHeaders

Birini eklemek için bu üye işlev çağrısı ya da daha fazla http istek üstbilgileri http isteğini işleme.

BOOL AddRequestHeaders(
   LPCTSTR pstrHeaders,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW,
   int dwHeadersLen = -1 
);
BOOL AddRequestHeaders(
   CString& str,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW 
);

Parametreler

  • pstrHeaders
    Üstbilgi veya istek eklemek için üstbilgi içeren bir dize için bir işaretçi.Her başlığı cr ve lf çifti tarafından sonlandırılması gerekir.

  • dwFlags
    Yeni üstbilgileri semantiği değiştirir.Aşağıdakilerden biri olabilir:

    • HTTP_ADDREQ_FLAG_COALESCEBaşlıkları izleyen başlıkta bulunan ilk üstbilgi eklemek için bayrağını kullanarak aynı adı birleştirir.Örneğin, "kabul et: metin / *" arkasından "kabul et: ses / *" sonuçları tek başlık biçiminde "kabul et: metin / *, ses / *".Getirdi düzenine göre coalesced veya ayrı Üstbilgilerle gönderilen istekleri tarafından alınan veri sağlamak için çağrıyı yapan uygulamaya demektir.

    • HTTP_ADDREQ_FLAG_REPLACEKaldır gerçekleştirir ve yerine geçerli üstbilgi ekleyin.Tam değer yeni üstbilgi eklemek için kullanılan ve üstbilgi adı geçerli üstbilgisini kaldırmak için kullanılır.Üstbilgi değeri boş ise ve üstbilgi bulundu, kaldırılır.Değilse boş üstbilgi değeri değiştirilir.

    • HTTP_ADDREQ_FLAG_ADD_IF_NEWZaten yoksa, yalnızca üstbilgisi ekler.Varsa, bir hata döndürdü.

    • HTTP_ADDREQ_FLAG_ADDYeni değer kullanılır.Yoksa, üstbilgisi ekler.

  • dwHeadersLen
    Karakter uzunluğu, pstrHeaders.Bu-1 l, daha sonra ise pstrHeaders sıfır sonlandırıldı olarak kabul edilir ve uzunluğu hesaplanır.

  • str
    Başvuru bir CString istek üstbilgisi veya eklenecek başlıkları içeren nesne.

Dönüş Değeri

Başarılı olursa sıfırdan farklı; Aksi halde 0.Çağrı başarısız olursa, Win32 fonksiyonu GetLastError hatanın nedenini belirlemek için çağrılabilir.

Notlar

AddRequestHeadersEk, serbest biçim üstbilgileri http istek işleyicisi ekler.Onu tam istek http sunucusuna gönderilen ayrıntılı denetime gereksinim duyan sofistike istemciler tarafından kullanılması amaçlanmıştır.

[!NOT]

Uygulama içinde birden çok üstbilgi geçirebilirsiniz pstrHeaders veya str için bir AddRequestHeaders çağrıda HTTP_ADDREQ_FLAG_ADD veya HTTP_ADDREQ_FLAG_ADD_IF_NEW.Uygulama Başlığı kullanarak değiştirmek veya kaldırmak çalışır, http_addreq_flag_remove veya HTTP_ADDREQ_FLAG_REPLACE, yalnızca bir başlık sağlanan lpszHeaders.

Gereksinimler

Başlık: afxinet.h

Ayrıca bkz.

Başvuru

CHttpFile sınıfı

Hiyerarşi grafik

CInternetFile sınıfı