HttpRemoveUrl 함수(http.h)

  • 아티클

HttpRemoveUrl 함수를 사용하면 시스템에서 지정된 UrlPrefix 문자열과 일치하는 요청을 지정된 요청 큐에 라우팅하는 것을 중지합니다.

HTTP Server API 버전 2.0부터 애플리케이션은 HttpRemoveUrlFromUrlGroup 을 호출하여 URL을 등록해야 합니다. HttpRemoveUrl을 사용하면 안 됩니다.

구문

HTTPAPI_LINKAGE ULONG HttpRemoveUrl(
  [in] HANDLE RequestQueueHandle,
  [in] PCWSTR FullyQualifiedUrl
);

매개 변수

[in] RequestQueueHandle

URL 등록을 제거할 요청 큐에 대한 핸들입니다. 요청 큐가 생성되고 HttpCreateRequestQueue 함수에 대한 호출에서 해당 핸들이 반환됩니다.

WINDOWS Server 2003 SP1 및 Windows XP SP2: 요청 큐에 대한 핸들은 HttpCreateHttpHandle 함수에 의해 만들어집니다.

[in] FullyQualifiedUrl

지정된 요청 큐에 등록된 UrlPrefix 문자열 에 대한 포인터입니다. 이 문자열은 UrlPrefix를 등록하려면 HttpAddUrl 에 전달된 문자열과 동일해야 합니다. IPv6 주소의 명명법 변경도 허용되지 않습니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 오류 코드 중 하나입니다.

값 의미
ERROR_ACCESS_DENIED
 호출하는 애플리케이션에는 URL을 제거할 수 있는 권한이 없습니다.
ERROR_INVALID_PARAMETER
 제공된 매개 변수 중 하나 이상이 사용할 수 없는 형식입니다.
ERROR_NOT_ENOUGH_MEMORY
 작업을 완료할 리소스가 부족합니다.
ERROR_FILE_NOT_FOUND
 지정된 UrlPrefix를 등록 데이터베이스에서 찾을 수 없습니다.
기타
 WinError.h에 정의된 시스템 오류 코드 입니다.

요구 사항

   
지원되는 최소 클라이언트 Windows Vista, WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 http.h
라이브러리 Httpapi.lib
DLL Httpapi.dll

참고 항목

HTTP Server API 버전 1.0 함수

HttpAddUrl

HttpRemoveUrlFromUrlGroup