BOOL GetServerVariable (LPTSTR lpszVariableName, LPVOID lpvBuffer, LPDWORD lpdwSize );
ส่งกลับค่า
ไม่ใช่ศูนย์ถ้าสำเร็จ 0 มิฉะนั้น การเรียก Win32 API GetLastErrorสามารถใช้เพื่อระบุว่าทำไมการเรียกล้มเหลวได้ มีค่าความผิดพลาดได้
ค่า | ความหมาย |
ERROR_INVALID_PARAMETER | หมายเลขอ้างอิงการเชื่อมต่อที่ไม่ถูกต้อง? |
ERROR_INVALID_INDEX | ระบุตัวแปรที่ไม่ถูกต้อง หรือไม่สนับสนุน? |
ERROR_INSUFFICIENT_BUFFER | บัฟเฟอร์เล็กเกินไป ส่งกลับค่าขนาดจำเป็นในlpdwSize? |
ERROR_MORE_DATA | บัฟเฟอร์เล็กเกินไป เฉพาะส่วนของข้อมูลที่ส่งกลับ ขนาดรวมของข้อมูลจะถูกส่งกลับ? |
ERROR_NO_DATA | ข้อมูลร้องขอไม่พร้อมใช้งาน? |
พารามิเตอร์
lpszVariableName
สายที่สิ้นสุดด้วยค่า null ซึ่งระบุตัวแปรที่มีการร้องขอ ดูส่วนหมายเหตุด้านล่างสำหรับการเลือกชื่อที่เป็นไปได้ ชื่อตัวแปรทั้งหมดเป็นไปตามที่กำหนดไว้ในสเปค CGI ซึ่งตั้งอยู่ที่http://hoohoo.ncsa.uiuc.edu/cgi/env.html?
lpvBuffer
ชี้การบัฟเฟอร์การรับข้อมูลที่ร้องขอ?
lpdwSize
ชี้เพื่อระบุจำนวนของไบต์ที่มีอยู่ในบัฟเฟอร์ DWORD บนสำเร็จ DWORD ประกอบด้วยจำนวนไบต์ที่ถูกโอนย้ายไปยังบัฟเฟอร์ (รวมถึงสิ้นสุดเป็น null ไบต์)?
หมายเหตุ
ฟังก์ชันนี้สมาชิกจะเรียกว่าโดยกรอบการคัดลอกข้อมูลที่เกี่ยวข้องกับ การเชื่อมต่อแบบ HTTP หรือเซิร์ฟเวอร์เอง ลงในบัฟเฟอร์ที่ระบุให้ โดยผู้เรียก รวมได้lpszVariableNames:
ค่า | ความหมาย |
ALL_HTTP | ส่วน HTTP หัวทั้งหมดที่ถูกไม่ได้วิเคราะห์เป็นหนึ่งในตัวแปรด้านบน ตัวแปรเหล่านี้มีฟอร์ม HTTP_lt ชื่อเขตข้อมูลหัวข้อ & gt? |
AUTH_TYPE | ประกอบด้วยชนิดของการรับรองความถูกต้อง used.nbsp ตัวอย่างเช่น ถ้ามีใช้การรับรองความถูกต้องพื้นฐาน สตริจะ "Basic" สำหรับ Windows NT Challenge-ตอบ ก็จะเป็น "NTLM" อื่น ๆ โครงร่างของการรับรองความถูกต้องจะมีสายอื่น ๆ เนื่องจากชนิดการรับรองความถูกต้องใหม่สามารถเพิ่มลงใน Internet Server ไม่สามารถเพื่อแสดงรายชื่อทุกสายอักขระที่เป็นไป ถ้าสตริงที่ว่างเปล่า แล้วไม่มีการรับรองความถูกต้องถูกใช้(&N)? |
CONTENT_LENGTH | จำนวนไบต์ที่สคริปต์คาดว่าจะได้รับจากไคลเอ็นต์? |
CONTENT_TYPE | ชนิดเนื้อหาของข้อมูลที่ให้ไว้ในเนื้อความของคำขอ POST? |
GATEWAY_INTERFACE | ตรวจทานแก้ไขของสเปค CGI ซึ่งเซิร์ฟเวอร์นี้สอดคล้อง รุ่นปัจจุบันคือ CGI/1.1? |
HTTP_ACCEPT | หัวข้อพิเศษกรณี HTTP ค่าของการยอมรับ: เขตข้อมูลมี concatenated คั่นด้วย ตัวอย่างเช่น ถ้าบรรทัดต่อไปนี้เป็นส่วนหนึ่งของส่วนหัว HTTP
แล้ว ตัวแปรHTTP_ACCEPTจะมีค่าเป็น:
|
PATH_INFO | เพิ่มเติมข้อมูลเส้นทาง กำหนดโดยไคลเอ็นต์ ประกอบนี้ด้วยส่วนต่อท้ายของ URL หลังชื่อสคริปต์ แต่ก่อนที่ จะสายอักขระแบบสอบถาม (ถ้ามี)? |
PATH_TRANSLATED | นี้คือ มูลค่าของPATH_INFOแต่ ด้วยชื่อเส้นทางเสมือนการขยายเข้าไปในไดเรกทอรีสเปคจะ? |
QUERY_STRING | ข้อมูลที่ตามหลัง?ใน URL ที่อ้างอิงถึงสคริปต์นี้? |
REMOTE_ADDR | อยู่ IP ของไคลเอ็นต์? |
REMOTE_HOST | ชื่อโฮสต์ของไคลเอ็นต์? |
REMOTE_USER | นี้ประกอบด้วยชื่อผู้ใช้ให้มา โดยไคลเอนต์ และรับรอง โดยเซิร์ฟเวอร์? |
REQUEST_METHOD | วิธีการร้องขอ HTTP? |
SCRIPT_NAME | ชื่อของโปรแกรมสคริปต์กำลังดำเนินการ? |
SERVER_NAME | ของเซิร์ฟเวอร์ชื่อโฮสต์ (หรือที่อยู่ IP) เป็นควรปรากฏขึ้นใน self-referencing Url? |
SERVER_PORT | พอร์ต TCP/IP ซึ่งได้รับการร้องขอ? |
SERVER_PROTOCOL | ชื่อและรุ่นของโพรโทคอลในการเรียกข้อมูลที่เกี่ยวข้องกับคำขอนี้ โดยปกติ HTTP/1.0? |
SERVER_SOFTWARE | ชื่อและรุ่นของเว็บเซิร์ฟเวอร์ที่เรียกใช้โปรแกรม CGI? |
ภาพรวม CHttpFilterContext |nbsp สมาชิกของคลาส| แผนภูมิของลำดับชั้น(&N)