2N/A<?
xml version="1.0" encoding="EUC-KR" ?>
2N/A<!-- English Revision: 395228:413220 (outdated) --> 2N/A Copyright 2004-2006 The Apache Software Foundation or its licensors, 2N/A Licensed under the Apache License, Version 2.0 (the "License"); 2N/A you may not use this file except in compliance with the License. 2N/A You may obtain a copy of the License at 2N/A Unless required by applicable law or agreed to in writing, software 2N/A distributed under the License is distributed on an "AS IS" BASIS, 2N/A WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 2N/A See the License for the specific language governing permissions and 2N/A limitations under the License. 2N/A<
name>mod_isapi</
name>
2N/A<
description>Windows�� ����ġ���� ISAPI Extension ���</
description>
2N/A<
status>Base</
status>
2N/A<
identifier>isapi_module</
identifier>
2N/A<
compatibility>Win32 only</
compatibility>
2N/A <
p>�� ����� Internet Server extension API�� �����Ѵ�. ����
2N/A ������ ������ Windows�� ����ġ���� Internet Server extension��
2N/A (<
em>��,</
em> ISAPI .dll ���) ����� �� �ִ�.</
p>
2N/A <
p>ISAPI extension ���(.dll ����)�� �����ڰ� �ۼ��Ѵ�.
2N/A Apache Group�� �̵� ����� ������ �ʾ�����, ���� ����
2N/A �ʴ´�. ISAPI extension ��뿡 ���� ������ ISAPI �����ڿ���
2N/A ���� �����ϱ� �ٶ���. <
strong>���� �̷� ������ ����ġ
2N/A ���ϸ�����Ʈ�� ������ �������� �ø��� <
em>����</
em>.</
strong></
p>
2N/A<
section id="usage"><
title>����</
title>
2N/A <
p>�����������Ͽ��� <
directive 2N/A module="mod_mime">AddHandler</
directive> ���þ ����Ͽ�
ISAPI ���� Ȯ���ڿ� <
code>isapi-handler</
code> �ڵ鷯�� �����Ѵ�.
.dll ������ ISAPI extension���� ó���Ϸ���
httpd.conf ���Ͽ�
AddHandler isapi-handler .dll
<
p>����ġ ������ ��û�� ����� �� ��� �� �� ���.
����
httpd.conf���� ������ ���� �������� Ư�� ����� �̸�
<
p>ISAPI extension�� �̸� �о���̴��� �̸� �о������ �ʴ���
������ ISAPI extension�� CGI ��ũ��Ʈ�� ������ ���Ѱ�
������ ���. ��, ISAPI .dll ������ �ִ� ���丮�� <
directive module="core">Options</
directive> <
code>ExecCGI</
code>��
<
p><
module>mod_isapi</
module>�� ISAPI ���� ���� �ڼ���
����� ������ <
a href="#notes">�߰� ����</
a>�� <
a href="#journal">������ ����</
a>�� ����϶�.</
p>
<
section id="notes"><
title>�߰� ����</
title>
<
p>����ġ ISAPI ������ �� ����¿� ���� "����ũ�μ���Ʈ
Ư����" Ȯ������ ������ ISAPI 2.0 �Ծ��� ��� �����Ѵ�.
����ġ�� ����� �����δ� ISAPI�� ����� �� �ִ� �������
�� ������� �� �� ���. ISA�� �� ����°� ���� ��������
�ʴ� ����� ����Ϸ� �Ѵٸ�, ����뿡 ������ �ֱ����� ����
�α� ����� �����. �αװ� �ſ� Ŀ�� �� �ֱ����
<
code>ISAPILogNotSupported Off</
code> ���þ ����ϸ�
<
p>Microsoft IIS�� ���� ������ ISAPI extension�� ��
�о�鿩�� �� ��뷮�� �ſ� ���� �ʰų� Ư���� ��������
�ʴ��� �״�� �� �д�. ����ġ�� ���� <
directive module="mod_isapi">ISAPICacheFile</
directive> ���þ �������
�ʴ´ٸ� ��û�� ���������� ISAPI extension�� �� �о���̰�
������. ��ȿ����������, ����ġ�� �� ������ �̰��� ����
ȿ������ ����̴�. ���� ISAPI ����� ����ġ ������ �ణ
ȣȯ�� �ȸ±���� ������ �������� ���� ����� ����
<
p>��, ����ġ�� ISAPI Extension�� ����������, <
strong>ISAPI
Filter�� �������� ������</
strong> ����϶�. ���߿� ����
������ �� ������, ����� ��ȹ�� ���.</
p>
<
section id="journal"><
title>������ ����</
title>
<
p>����ġ 2.0 <
module>mod_isapi</
module> ����� ���α����Ѵٸ�,
<
code>ServerSupportFunction</
code> ȣ���� ���� ���þ��
<
dt><
code>HSE_REQ_SEND_URL_REDIRECT_RESP</
code></
dt>
<
dd>����ڸ� �ٸ� ��ġ�� �����̷����Ѵ�.<
br />
������ URL�� ����ؾ� �Ѵ� (<
em>���� ���,</
em>
<
dt><
code>HSE_REQ_SEND_URL</
code></
dt>
<
dd>����ڸ� �ٸ� ��ġ�� �����̷����Ѵ�.<
br />
������ URL�� �ƴϸ�, �������ݰ� �������� �ѱ� �� ���
(<
em>���� ���,</
em> <
code>/location</
code>���� �� ����).<
br />
������ �ƴ϶� ������ �����̷����� ó���Ѵ�.<
br />
<
note type="warning"><
title>���</
title>
<
p>�ֱ� ������ ���� Microsoft�� �� <
code>HSE_REQ_SEND_URL</
code>
��ɰ��� ���̸� ��� ��ó�� ���δ�. ����ġ�� ��� ��
���� �ƱԸ�Ʈ ���ǰ� �ൿ�� �ٸ��� ó���� ���̴�.</
p>
<
dt><
code>HSE_REQ_SEND_RESPONSE_HEADER</
code></
dt>
<
dd>headers ���ڿ� �ƱԸ�Ʈ�� ������ (�ٹٲ��ڰ� �ι�
����) �ִٸ� ����ġ�� ��� ���� ������ ���� �������� ����Ѵ�.
headers �ƱԸ�Ʈ�� NULL�� ���������, ���� ���뿡 NULL��
<
dt><
code>HSE_REQ_DONE_WITH_SESSION</
code></
dt>
<
dd>ISAPI�� ó���� ��ġ�� ������ ��������� ����ġ��
<
dt><
code>HSE_REQ_MAP_URL_TO_PATH</
code></
dt>
<
dd>����ġ�� ���� �̸��� ������(����) �̸����� ��ȯ�Ѵ�.</
dd>
<
dt><
code>HSE_APPEND_LOG_PARAMETER</
code></
dt>
������ �Ʒ� �α��� �Ѱ��� �����.
<
li><
directive module="mod_log_config">CustomLog</
directive>
���þ��� <
code>\"%{isapi-parameter}n\"</
code> ��</
li>
<
li><
directive module="mod_isapi">ISAPIAppendLogToQuery</
directive>
<
code>On</
code> ���þ ����Ͽ� <
code>%q</
code>
module="mod_isapi">ISAPIAppendLogToErrors</
directive>
<
code>On</
code> ���þ ����Ͽ� ���� �α�</
li>
<
p>ù��°�� ���� <
code>%{isapi-parameter}n</
code> ����
������ ����� �� ������ �����Ѵ�.</
p>
<
dt><
code>HSE_REQ_IS_KEEP_CONN</
code></
dt>
<
dd>���� Keep-Alive ���¸� ��ȯ�Ѵ�.</
dd>
<
dt><
code>HSE_REQ_SEND_RESPONSE_HEADER_EX</
code></
dt>
<
dd><
code>fKeepConn</
code> �ɼ��� �����ϴ� ���� �����ϰ��
������ ���µ��� �����Ѵ�.</
dd>
<
dt><
code>HSE_REQ_IS_CONNECTED</
code></
dt>
<
dd>��û�� �߰��� �������ٸ� false�� ��ȯ�Ѵ�.</
dd>
<
p>�������� �ʴ� <
code>ServerSupportFunction</
code> ȣ����
�ϸ� ����ġ�� <
code>FALSE</
code>�� ��ȯ�ϰ�
<
code>GetLastError</
code> ����
<
code>ERROR_INVALID_PARAMETER</
code>�� �����Ѵ�.</
p>
<
p><
code>ReadClient</
code>�� (<
directive module="mod_isapi">ISAPIReadAheadBuffer</
directive>�� ������)
�ʱ����ũ�⸦ �Ѿ ��û ������ �����´�.
<
directive>ISAPIReadAheadBuffer</
directive> ���� (ISAPI
�ڵ鷯�� �θ����� ������ ����Ʈ��) ���� ª�� ��û�� extension��
�θ��� ��� ��ȴ�. ��û�� ���, ISAPI extension��
<
code>ReadClient</
code>�� ������ ��û ������ �����;� �Ѵ�.</
p>
<
p><
code>WriteClient</
code>�� ����������,
<
code>HSE_IO_SYNC</
code> �ɼǸ� ����ϰų� (<
code>0</
code>
��) �ƹ� �ɼǵ� ������� �ʾƾ� �Ѵ�. �ٸ�
<
code>WriteClient</
code> ��û�� <
code>FALSE</
code>�� ��ȯ�ϸ�
�����ϰ�, <
code>GetLastError</
code> ����
<
code>ERROR_INVALID_PARAMETER</
code>�� �ȴ�.</
p>
<
p><
code>GetServerVariable</
code>�� ����������, (�ٸ� ��������
�����ϴ�) Ȯ�� ���������� ���.
<
code>GetServerVariable</
code>���� ��� �Ϲ����� ����ġ
CGI ȯ�溯���� <
code>ALL_HTTP</
code>, <
code>ALL_RAW</
code>
<
p>����ġ 2.0 <
module>mod_isapi</
module>�� ���� ISAPI �Ծ
���� �߰� ����� �����ϰ�, �� ����°�
<
code>TransmitFile</
code> ����� ���� �䳻����. ��, ISAPI
.dll�� �̸� �о�鿩�� ������ ���̴� ����ġ 1.3
<
code>mod_isapi</
code>���� ��� ����� �����Ѵ�.</
p>
<
name>ISAPICacheFile</
name>
<
description>������ �����Ҷ� �� �о���� ISAPI .dll ���ϵ�</
description>
<
syntax>ISAPICacheFile <
var>file-path</
var> [<
var>file-path</
var>]
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
p>����ġ ������ �����Ҷ� �� �о�鿩�� ������ �����Ҷ�����
�� �������� ���ϸ��� ������� �����Ͽ� �����Ѵ�. ��
���þ�� ISAPI .dll ���Ϻ��� ������ ����� �� �ִ�. ������
��ü ��θ� ��´�. ��� ��ΰ� �ƴϸ� <
directive module="core">ServerRoot</
directive>�� ��� ��η� �Ƶ��δ�.</
p>
<
name>ISAPIReadAheadBuffer</
name>
<
description>ISAPI extension�� �̸��б����(read ahead buffer)
<
syntax>ISAPIReadAheadBuffer <
var>size</
var></
syntax>
<
default>ISAPIReadAheadBuffer 49152</
default>
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
context>directory</
context><
context>.htaccess</
context></
contextlist>
<
override>FileInfo</
override>
<
p>ISAPI extension�� ó�� ȣ���Ҷ� �̸��б������ �ִ� ũ�⸦
�����Ѵ�. (�� ũ�⺸�� ū) ������ �ڷ�� <
code>ReadClient</
code>
�ݹ��� ����Ͽ� �о�� �Ѵ�. � ISAPI extension��
<
code>ReadClient</
code> ����� �������� �ʴ´�. �� ���
ISAPI extension �����ڿ��� �����϶�.</
p>
<
name>ISAPILogNotSupported</
name>
<
description>ISAPI extension�� �������� �ʴ� ����� ��û�ϸ�
�α� ����Ѵ�</
description>
<
syntax>ISAPILogNotSupported on|off</
syntax>
<
default>ISAPILogNotSupported off</
default>
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
context>directory</
context><
context>.htaccess</
context></
contextlist>
<
override>FileInfo</
override>
<
p>ISAPI extension�� �������� �ʴ� ����� ��û�ϸ� ����
���� �α� ����Ѵ�. ���߿� ���ڰ� ������ �����ϴµ�
������ �ȴ�. ���ϴ� ��� ISAPI ����� ���������� �����ϸ�
�ٽ� off�� �ǵ����� �Ѵ�.</
p>
<
name>ISAPIAppendLogToErrors</
name>
<
description>ISAPI exntension�� <
code>HSE_APPEND_LOG_PARAMETER</
code>
��û�� ���� �α� ����Ѵ�</
description>
<
syntax>ISAPIAppendLogToErrors on|off</
syntax>
<
default>ISAPIAppendLogToErrors off</
default>
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
context>directory</
context><
context>.htaccess</
context></
contextlist>
<
override>FileInfo</
override>
<
p>ISAPI exntension�� <
code>HSE_APPEND_LOG_PARAMETER</
code>
��û�� ���� �α� ����Ѵ�.</
p>
<
name>ISAPIAppendLogToQuery</
name>
<
description>ISAPI exntension�� <
code>HSE_APPEND_LOG_PARAMETER</
code>
��û�� ���ǹ��ڿ��� ����Ѵ�</
description>
<
syntax>ISAPIAppendLogToQuery on|off</
syntax>
<
default>ISAPIAppendLogToQuery on</
default>
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
context>directory</
context><
context>.htaccess</
context></
contextlist>
<
override>FileInfo</
override>
<
p>ISAPI exntension�� <
code>HSE_APPEND_LOG_PARAMETER</
code>
��û�� ���ǹ��ڿ��� ����Ѵ� (<
directive module="mod_log_config">CustomLog</
directive> <
code>%q</
code>
<
name>ISAPIFakeAsync</
name>
<
description>�� ISAPI �ݹ��� �����ϴ� ô�Ѵ�</
description>
<
syntax>ISAPIFakeAsync on|off</
syntax>
<
default>ISAPIFakeAsync off</
default>
<
contextlist><
context>server config</
context><
context>virtual host</
context>
<
context>directory</
context><
context>.htaccess</
context></
contextlist>
<
override>FileInfo</
override>
<
p>on���� �����ϸ� �� ISAPI �ݹ� ������ �䳻����.</
p>