2 * Copyright 2005 Jacek Caban
3 * Copyright 2007 Misha Koshelev
5 * This library is free software; you can redistribute it and/or
6 * modify it under the terms of the GNU Lesser General Public
7 * License as published by the Free Software Foundation; either
8 * version 2.1 of the License, or (at your option) any later version.
10 * This library is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 * Lesser General Public License for more details.
15 * You should have received a copy of the GNU Lesser General Public
16 * License along with this library; if not, write to the Free Software
17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
22 * - Handle redirects as native.
25 #include "urlmon_main.h"
28 #include "wine/debug.h"
30 WINE_DEFAULT_DEBUG_CHANNEL(urlmon
);
35 const IInternetProtocolVtbl
*lpIInternetProtocolVtbl
;
36 const IInternetPriorityVtbl
*lpInternetPriorityVtbl
;
37 const IWinInetHttpInfoVtbl
*lpWinInetHttpInfoVtbl
;
40 IHttpNegotiate
*http_negotiate
;
46 #define PRIORITY(x) ((IInternetPriority*) &(x)->lpInternetPriorityVtbl)
47 #define INETHTTPINFO(x) ((IWinInetHttpInfo*) &(x)->lpWinInetHttpInfoVtbl)
49 /* Default headers from native */
50 static const WCHAR wszHeaders
[] = {'A','c','c','e','p','t','-','E','n','c','o','d','i','n','g',
51 ':',' ','g','z','i','p',',',' ','d','e','f','l','a','t','e',0};
53 static LPWSTR
query_http_info(HttpProtocol
*This
, DWORD option
)
59 res
= HttpQueryInfoW(This
->base
.request
, option
, NULL
, &len
, NULL
);
60 if (!res
&& GetLastError() == ERROR_INSUFFICIENT_BUFFER
) {
61 ret
= heap_alloc(len
);
62 res
= HttpQueryInfoW(This
->base
.request
, option
, ret
, &len
, NULL
);
65 TRACE("HttpQueryInfoW(%d) failed: %08x\n", option
, GetLastError());
73 #define ASYNCPROTOCOL_THIS(iface) DEFINE_THIS2(HttpProtocol, base, iface)
75 static HRESULT
HttpProtocol_open_request(Protocol
*prot
, LPCWSTR url
, DWORD request_flags
,
76 HINTERNET internet_session
, IInternetBindInfo
*bind_info
)
78 HttpProtocol
*This
= ASYNCPROTOCOL_THIS(prot
);
79 LPWSTR addl_header
= NULL
, post_cookie
= NULL
, optional
= NULL
;
80 IServiceProvider
*service_provider
= NULL
;
81 IHttpNegotiate2
*http_negotiate2
= NULL
;
82 LPWSTR host
, user
, pass
, path
;
83 LPOLESTR accept_mimes
[257];
84 URL_COMPONENTSW url_comp
;
85 BYTE security_id
[512];
91 static const WCHAR wszBindVerb
[BINDVERB_CUSTOM
][5] =
96 memset(&url_comp
, 0, sizeof(url_comp
));
97 url_comp
.dwStructSize
= sizeof(url_comp
);
98 url_comp
.dwSchemeLength
= url_comp
.dwHostNameLength
= url_comp
.dwUrlPathLength
=
99 url_comp
.dwUserNameLength
= url_comp
.dwPasswordLength
= 1;
100 if (!InternetCrackUrlW(url
, 0, 0, &url_comp
))
104 url_comp
.nPort
= This
->https
? INTERNET_DEFAULT_HTTPS_PORT
: INTERNET_DEFAULT_HTTP_PORT
;
106 host
= heap_strndupW(url_comp
.lpszHostName
, url_comp
.dwHostNameLength
);
107 user
= heap_strndupW(url_comp
.lpszUserName
, url_comp
.dwUserNameLength
);
108 pass
= heap_strndupW(url_comp
.lpszPassword
, url_comp
.dwPasswordLength
);
109 This
->base
.connection
= InternetConnectW(internet_session
, host
, url_comp
.nPort
, user
, pass
,
110 INTERNET_SERVICE_HTTP
, This
->https
? INTERNET_FLAG_SECURE
: 0, (DWORD_PTR
)&This
->base
);
114 if(!This
->base
.connection
) {
115 WARN("InternetConnect failed: %d\n", GetLastError());
116 return INET_E_CANNOT_CONNECT
;
119 num
= sizeof(accept_mimes
)/sizeof(accept_mimes
[0])-1;
120 hres
= IInternetBindInfo_GetBindString(bind_info
, BINDSTRING_ACCEPT_MIMES
, accept_mimes
, num
, &num
);
122 WARN("GetBindString BINDSTRING_ACCEPT_MIMES failed: %08x\n", hres
);
123 return INET_E_NO_VALID_MEDIA
;
125 accept_mimes
[num
] = 0;
127 path
= heap_strndupW(url_comp
.lpszUrlPath
, url_comp
.dwUrlPathLength
);
129 request_flags
|= INTERNET_FLAG_SECURE
;
130 This
->base
.request
= HttpOpenRequestW(This
->base
.connection
,
131 This
->base
.bind_info
.dwBindVerb
< BINDVERB_CUSTOM
132 ? wszBindVerb
[This
->base
.bind_info
.dwBindVerb
] : This
->base
.bind_info
.szCustomVerb
,
133 path
, NULL
, NULL
, (LPCWSTR
*)accept_mimes
, request_flags
, (DWORD_PTR
)&This
->base
);
135 while (num
<sizeof(accept_mimes
)/sizeof(accept_mimes
[0]) && accept_mimes
[num
])
136 CoTaskMemFree(accept_mimes
[num
++]);
137 if (!This
->base
.request
) {
138 WARN("HttpOpenRequest failed: %d\n", GetLastError());
139 return INET_E_RESOURCE_NOT_FOUND
;
142 hres
= IInternetProtocolSink_QueryInterface(This
->base
.protocol_sink
, &IID_IServiceProvider
,
143 (void **)&service_provider
);
145 WARN("IInternetProtocolSink_QueryInterface IID_IServiceProvider failed: %08x\n", hres
);
149 hres
= IServiceProvider_QueryService(service_provider
, &IID_IHttpNegotiate
,
150 &IID_IHttpNegotiate
, (void **)&This
->http_negotiate
);
152 WARN("IServiceProvider_QueryService IID_IHttpNegotiate failed: %08x\n", hres
);
156 hres
= IHttpNegotiate_BeginningTransaction(This
->http_negotiate
, url
, wszHeaders
,
159 WARN("IHttpNegotiate_BeginningTransaction failed: %08x\n", hres
);
160 IServiceProvider_Release(service_provider
);
165 int len_addl_header
= strlenW(addl_header
);
167 This
->full_header
= heap_alloc(len_addl_header
*sizeof(WCHAR
)+sizeof(wszHeaders
));
169 lstrcpyW(This
->full_header
, addl_header
);
170 lstrcpyW(&This
->full_header
[len_addl_header
], wszHeaders
);
171 CoTaskMemFree(addl_header
);
173 This
->full_header
= (LPWSTR
)wszHeaders
;
176 hres
= IServiceProvider_QueryService(service_provider
, &IID_IHttpNegotiate2
,
177 &IID_IHttpNegotiate2
, (void **)&http_negotiate2
);
178 IServiceProvider_Release(service_provider
);
180 WARN("IServiceProvider_QueryService IID_IHttpNegotiate2 failed: %08x\n", hres
);
181 /* No goto done as per native */
183 len
= sizeof(security_id
)/sizeof(security_id
[0]);
184 hres
= IHttpNegotiate2_GetRootSecurityId(http_negotiate2
, security_id
, &len
, 0);
185 IHttpNegotiate2_Release(http_negotiate2
);
187 WARN("IHttpNegotiate2_GetRootSecurityId failed: %08x\n", hres
);
190 /* FIXME: Handle security_id. Native calls undocumented function IsHostInProxyBypassList. */
192 if(This
->base
.bind_info
.dwBindVerb
== BINDVERB_POST
) {
194 hres
= IInternetBindInfo_GetBindString(bind_info
, BINDSTRING_POST_COOKIE
, &post_cookie
, 1, &num
);
195 if(hres
== S_OK
&& num
) {
196 if(!InternetSetOptionW(This
->base
.request
, INTERNET_OPTION_SECONDARY_CACHE_KEY
,
197 post_cookie
, lstrlenW(post_cookie
)))
198 WARN("InternetSetOption INTERNET_OPTION_SECONDARY_CACHE_KEY failed: %d\n", GetLastError());
199 CoTaskMemFree(post_cookie
);
203 if(This
->base
.bind_info
.dwBindVerb
!= BINDVERB_GET
) {
204 /* Native does not use GlobalLock/GlobalUnlock, so we won't either */
205 if (This
->base
.bind_info
.stgmedData
.tymed
!= TYMED_HGLOBAL
)
206 WARN("Expected This->base.bind_info.stgmedData.tymed to be TYMED_HGLOBAL, not %d\n",
207 This
->base
.bind_info
.stgmedData
.tymed
);
209 optional
= (LPWSTR
)This
->base
.bind_info
.stgmedData
.u
.hGlobal
;
213 res
= InternetSetOptionW(This
->base
.request
, INTERNET_OPTION_HTTP_DECODING
, &b
, sizeof(b
));
215 WARN("InternetSetOption(INTERNET_OPTION_HTTP_DECODING) failed: %08x\n", GetLastError());
217 res
= HttpSendRequestW(This
->base
.request
, This
->full_header
, lstrlenW(This
->full_header
),
218 optional
, optional
? This
->base
.bind_info
.cbstgmedData
: 0);
219 if(!res
&& GetLastError() != ERROR_IO_PENDING
) {
220 WARN("HttpSendRequest failed: %d\n", GetLastError());
221 return INET_E_DOWNLOAD_FAILURE
;
227 static HRESULT
HttpProtocol_start_downloading(Protocol
*prot
)
229 HttpProtocol
*This
= ASYNCPROTOCOL_THIS(prot
);
230 LPWSTR content_type
= 0, content_length
= 0;
231 DWORD len
= sizeof(DWORD
);
236 static const WCHAR wszDefaultContentType
[] =
237 {'t','e','x','t','/','h','t','m','l',0};
239 if(!This
->http_negotiate
) {
240 WARN("Expected IHttpNegotiate pointer to be non-NULL\n");
244 res
= HttpQueryInfoW(This
->base
.request
, HTTP_QUERY_STATUS_CODE
| HTTP_QUERY_FLAG_NUMBER
,
245 &status_code
, &len
, NULL
);
247 LPWSTR response_headers
= query_http_info(This
, HTTP_QUERY_RAW_HEADERS_CRLF
);
248 if(response_headers
) {
249 hres
= IHttpNegotiate_OnResponse(This
->http_negotiate
, status_code
, response_headers
,
251 heap_free(response_headers
);
253 WARN("IHttpNegotiate_OnResponse failed: %08x\n", hres
);
258 WARN("HttpQueryInfo failed: %d\n", GetLastError());
262 IInternetProtocolSink_ReportProgress(This
->base
.protocol_sink
, BINDSTATUS_ACCEPTRANGES
, NULL
);
264 content_type
= query_http_info(This
, HTTP_QUERY_CONTENT_TYPE
);
266 /* remove the charset, if present */
267 LPWSTR p
= strchrW(content_type
, ';');
270 IInternetProtocolSink_ReportProgress(This
->base
.protocol_sink
,
271 (This
->base
.bindf
& BINDF_FROMURLMON
)
272 ? BINDSTATUS_MIMETYPEAVAILABLE
: BINDSTATUS_RAWMIMETYPE
,
274 heap_free(content_type
);
276 WARN("HttpQueryInfo failed: %d\n", GetLastError());
277 IInternetProtocolSink_ReportProgress(This
->base
.protocol_sink
,
278 (This
->base
.bindf
& BINDF_FROMURLMON
)
279 ? BINDSTATUS_MIMETYPEAVAILABLE
: BINDSTATUS_RAWMIMETYPE
,
280 wszDefaultContentType
);
283 content_length
= query_http_info(This
, HTTP_QUERY_CONTENT_LENGTH
);
285 This
->base
.content_length
= atoiW(content_length
);
286 heap_free(content_length
);
292 static void HttpProtocol_close_connection(Protocol
*prot
)
294 HttpProtocol
*This
= ASYNCPROTOCOL_THIS(prot
);
296 if(This
->http_negotiate
) {
297 IHttpNegotiate_Release(This
->http_negotiate
);
298 This
->http_negotiate
= 0;
301 if(This
->full_header
) {
302 if(This
->full_header
!= wszHeaders
)
303 heap_free(This
->full_header
);
304 This
->full_header
= 0;
308 #undef ASYNCPROTOCOL_THIS
310 static const ProtocolVtbl AsyncProtocolVtbl
= {
311 HttpProtocol_open_request
,
312 HttpProtocol_start_downloading
,
313 HttpProtocol_close_connection
316 #define PROTOCOL_THIS(iface) DEFINE_THIS(HttpProtocol, IInternetProtocol, iface)
318 static HRESULT WINAPI
HttpProtocol_QueryInterface(IInternetProtocol
*iface
, REFIID riid
, void **ppv
)
320 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
323 if(IsEqualGUID(&IID_IUnknown
, riid
)) {
324 TRACE("(%p)->(IID_IUnknown %p)\n", This
, ppv
);
325 *ppv
= PROTOCOL(This
);
326 }else if(IsEqualGUID(&IID_IInternetProtocolRoot
, riid
)) {
327 TRACE("(%p)->(IID_IInternetProtocolRoot %p)\n", This
, ppv
);
328 *ppv
= PROTOCOL(This
);
329 }else if(IsEqualGUID(&IID_IInternetProtocol
, riid
)) {
330 TRACE("(%p)->(IID_IInternetProtocol %p)\n", This
, ppv
);
331 *ppv
= PROTOCOL(This
);
332 }else if(IsEqualGUID(&IID_IInternetPriority
, riid
)) {
333 TRACE("(%p)->(IID_IInternetPriority %p)\n", This
, ppv
);
334 *ppv
= PRIORITY(This
);
335 }else if(IsEqualGUID(&IID_IWinInetInfo
, riid
)) {
336 TRACE("(%p)->(IID_IWinInetInfo %p)\n", This
, ppv
);
337 *ppv
= INETHTTPINFO(This
);
338 }else if(IsEqualGUID(&IID_IWinInetHttpInfo
, riid
)) {
339 TRACE("(%p)->(IID_IWinInetHttpInfo %p)\n", This
, ppv
);
340 *ppv
= INETHTTPINFO(This
);
344 IInternetProtocol_AddRef(iface
);
348 WARN("not supported interface %s\n", debugstr_guid(riid
));
349 return E_NOINTERFACE
;
352 static ULONG WINAPI
HttpProtocol_AddRef(IInternetProtocol
*iface
)
354 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
355 LONG ref
= InterlockedIncrement(&This
->ref
);
356 TRACE("(%p) ref=%d\n", This
, ref
);
360 static ULONG WINAPI
HttpProtocol_Release(IInternetProtocol
*iface
)
362 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
363 LONG ref
= InterlockedDecrement(&This
->ref
);
365 TRACE("(%p) ref=%d\n", This
, ref
);
368 protocol_close_connection(&This
->base
);
371 URLMON_UnlockModule();
377 static HRESULT WINAPI
HttpProtocol_Start(IInternetProtocol
*iface
, LPCWSTR szUrl
,
378 IInternetProtocolSink
*pOIProtSink
, IInternetBindInfo
*pOIBindInfo
,
379 DWORD grfPI
, HANDLE_PTR dwReserved
)
381 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
383 static const WCHAR httpW
[] = {'h','t','t','p',':'};
384 static const WCHAR httpsW
[] = {'h','t','t','p','s',':'};
386 TRACE("(%p)->(%s %p %p %08x %lx)\n", This
, debugstr_w(szUrl
), pOIProtSink
,
387 pOIBindInfo
, grfPI
, dwReserved
);
390 ? strncmpW(szUrl
, httpsW
, sizeof(httpsW
)/sizeof(WCHAR
))
391 : strncmpW(szUrl
, httpW
, sizeof(httpW
)/sizeof(WCHAR
)))
394 return protocol_start(&This
->base
, PROTOCOL(This
), szUrl
, pOIProtSink
, pOIBindInfo
);
397 static HRESULT WINAPI
HttpProtocol_Continue(IInternetProtocol
*iface
, PROTOCOLDATA
*pProtocolData
)
399 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
401 TRACE("(%p)->(%p)\n", This
, pProtocolData
);
403 return protocol_continue(&This
->base
, pProtocolData
);
406 static HRESULT WINAPI
HttpProtocol_Abort(IInternetProtocol
*iface
, HRESULT hrReason
,
409 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
410 FIXME("(%p)->(%08x %08x)\n", This
, hrReason
, dwOptions
);
414 static HRESULT WINAPI
HttpProtocol_Terminate(IInternetProtocol
*iface
, DWORD dwOptions
)
416 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
418 TRACE("(%p)->(%08x)\n", This
, dwOptions
);
420 protocol_close_connection(&This
->base
);
424 static HRESULT WINAPI
HttpProtocol_Suspend(IInternetProtocol
*iface
)
426 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
427 FIXME("(%p)\n", This
);
431 static HRESULT WINAPI
HttpProtocol_Resume(IInternetProtocol
*iface
)
433 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
434 FIXME("(%p)\n", This
);
438 static HRESULT WINAPI
HttpProtocol_Read(IInternetProtocol
*iface
, void *pv
,
439 ULONG cb
, ULONG
*pcbRead
)
441 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
443 TRACE("(%p)->(%p %u %p)\n", This
, pv
, cb
, pcbRead
);
445 return protocol_read(&This
->base
, pv
, cb
, pcbRead
);
448 static HRESULT WINAPI
HttpProtocol_Seek(IInternetProtocol
*iface
, LARGE_INTEGER dlibMove
,
449 DWORD dwOrigin
, ULARGE_INTEGER
*plibNewPosition
)
451 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
452 FIXME("(%p)->(%d %d %p)\n", This
, dlibMove
.u
.LowPart
, dwOrigin
, plibNewPosition
);
456 static HRESULT WINAPI
HttpProtocol_LockRequest(IInternetProtocol
*iface
, DWORD dwOptions
)
458 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
460 TRACE("(%p)->(%08x)\n", This
, dwOptions
);
462 return protocol_lock_request(&This
->base
);
465 static HRESULT WINAPI
HttpProtocol_UnlockRequest(IInternetProtocol
*iface
)
467 HttpProtocol
*This
= PROTOCOL_THIS(iface
);
469 TRACE("(%p)\n", This
);
471 return protocol_unlock_request(&This
->base
);
476 static const IInternetProtocolVtbl HttpProtocolVtbl
= {
477 HttpProtocol_QueryInterface
,
479 HttpProtocol_Release
,
481 HttpProtocol_Continue
,
483 HttpProtocol_Terminate
,
484 HttpProtocol_Suspend
,
488 HttpProtocol_LockRequest
,
489 HttpProtocol_UnlockRequest
492 #define PRIORITY_THIS(iface) DEFINE_THIS(HttpProtocol, InternetPriority, iface)
494 static HRESULT WINAPI
HttpPriority_QueryInterface(IInternetPriority
*iface
, REFIID riid
, void **ppv
)
496 HttpProtocol
*This
= PRIORITY_THIS(iface
);
497 return IInternetProtocol_QueryInterface(PROTOCOL(This
), riid
, ppv
);
500 static ULONG WINAPI
HttpPriority_AddRef(IInternetPriority
*iface
)
502 HttpProtocol
*This
= PRIORITY_THIS(iface
);
503 return IInternetProtocol_AddRef(PROTOCOL(This
));
506 static ULONG WINAPI
HttpPriority_Release(IInternetPriority
*iface
)
508 HttpProtocol
*This
= PRIORITY_THIS(iface
);
509 return IInternetProtocol_Release(PROTOCOL(This
));
512 static HRESULT WINAPI
HttpPriority_SetPriority(IInternetPriority
*iface
, LONG nPriority
)
514 HttpProtocol
*This
= PRIORITY_THIS(iface
);
516 TRACE("(%p)->(%d)\n", This
, nPriority
);
518 This
->base
.priority
= nPriority
;
522 static HRESULT WINAPI
HttpPriority_GetPriority(IInternetPriority
*iface
, LONG
*pnPriority
)
524 HttpProtocol
*This
= PRIORITY_THIS(iface
);
526 TRACE("(%p)->(%p)\n", This
, pnPriority
);
528 *pnPriority
= This
->base
.priority
;
534 static const IInternetPriorityVtbl HttpPriorityVtbl
= {
535 HttpPriority_QueryInterface
,
537 HttpPriority_Release
,
538 HttpPriority_SetPriority
,
539 HttpPriority_GetPriority
542 #define INETINFO_THIS(iface) DEFINE_THIS(HttpProtocol, WinInetHttpInfo, iface)
544 static HRESULT WINAPI
HttpInfo_QueryInterface(IWinInetHttpInfo
*iface
, REFIID riid
, void **ppv
)
546 HttpProtocol
*This
= INETINFO_THIS(iface
);
547 return IBinding_QueryInterface(PROTOCOL(This
), riid
, ppv
);
550 static ULONG WINAPI
HttpInfo_AddRef(IWinInetHttpInfo
*iface
)
552 HttpProtocol
*This
= INETINFO_THIS(iface
);
553 return IBinding_AddRef(PROTOCOL(This
));
556 static ULONG WINAPI
HttpInfo_Release(IWinInetHttpInfo
*iface
)
558 HttpProtocol
*This
= INETINFO_THIS(iface
);
559 return IBinding_Release(PROTOCOL(This
));
562 static HRESULT WINAPI
HttpInfo_QueryOption(IWinInetHttpInfo
*iface
, DWORD dwOption
,
563 void *pBuffer
, DWORD
*pcbBuffer
)
565 HttpProtocol
*This
= INETINFO_THIS(iface
);
566 FIXME("(%p)->(%x %p %p)\n", This
, dwOption
, pBuffer
, pcbBuffer
);
570 static HRESULT WINAPI
HttpInfo_QueryInfo(IWinInetHttpInfo
*iface
, DWORD dwOption
,
571 void *pBuffer
, DWORD
*pcbBuffer
, DWORD
*pdwFlags
, DWORD
*pdwReserved
)
573 HttpProtocol
*This
= INETINFO_THIS(iface
);
574 FIXME("(%p)->(%x %p %p %p %p)\n", This
, dwOption
, pBuffer
, pcbBuffer
, pdwFlags
, pdwReserved
);
580 static const IWinInetHttpInfoVtbl WinInetHttpInfoVtbl
= {
581 HttpInfo_QueryInterface
,
584 HttpInfo_QueryOption
,
588 static HRESULT
create_http_protocol(BOOL https
, void **ppobj
)
592 ret
= heap_alloc_zero(sizeof(HttpProtocol
));
594 return E_OUTOFMEMORY
;
596 ret
->base
.vtbl
= &AsyncProtocolVtbl
;
597 ret
->lpIInternetProtocolVtbl
= &HttpProtocolVtbl
;
598 ret
->lpInternetPriorityVtbl
= &HttpPriorityVtbl
;
599 ret
->lpWinInetHttpInfoVtbl
= &WinInetHttpInfoVtbl
;
604 *ppobj
= PROTOCOL(ret
);
610 HRESULT
HttpProtocol_Construct(IUnknown
*pUnkOuter
, LPVOID
*ppobj
)
612 TRACE("(%p %p)\n", pUnkOuter
, ppobj
);
614 return create_http_protocol(FALSE
, ppobj
);
617 HRESULT
HttpSProtocol_Construct(IUnknown
*pUnkOuter
, LPVOID
*ppobj
)
619 TRACE("(%p %p)\n", pUnkOuter
, ppobj
);
621 return create_http_protocol(TRUE
, ppobj
);