NPN_PostURLNotify

개요

지정한 URL로 POST 호출하고, 결과 알림을 받는다.

문법

#include <npapi.h>
 
NPError NPN_PostURLNotify(NPP         instance,
                          const char* url, 
                          const char* target,
                          uint32      len, 
                          const char* buf,
                          NPBool      file, 
                          void*       notifyData);

파라메터

함수는 다음과 같은 파라메터를 입력받는다:

instance
현재 플러그인 인스턴스, specified by the plug-in.
url
POST 호출할 URL, 플러그인.
target
대상 윈도우, specified by the plug-in. 자세한 설명은 NPN_GetURL을 보라.
len
buf의 길이.
buf
로컬 임시 파일 경로, 또는 POST로 전송할 데이터 버퍼.
file
파일을 POST로 전송할지 여부:
  • true: buf에 지정된 로컬 파일을 전송하고, 완료되면 파일은 삭제한다.
  • false: buf에 있는 데이터를 직접 전송한다.
notifydata
POST 요청을 식별하기 위한 값. NPP_URLNotify의 호출에 의해 이 값이 전달된다. (아래 설명을 보라).

반환값

  • 성공하면 NPERR_NO_ERROR을 리턴한다.
  • 실패하면 플러그인은 로드되지 않고, 에러 코드를 리턴한다. 에러값은 Error Codes 를 보라.

설명

NPN_PostURLNotify 함수는 NPN_PostURL와 거의 같지만, 다음과 같은 차이가 있다:

  • NPN_PostURLNotify 는 메모리 버퍼를 사용할 때 헤더를 지정할 수 있다.
  • NPN_PostURLNotify 는 성공하든 실패하든 요청이 완료되면 NPP_URLNotify를 호출한다. 더 자세한 설명을 보려면 NPN_PostURL을 보도록 한다.

NPN_PostURLNotify는 비동기로 동작한다: 함수는 바로 리턴되고, 요청이 처리되면 NPP_URLNotify를 호출한다.

If this function is called with a target parameter value of _self or a parent to _self, this function should return an INVALID_PARAM NPError. This is the only way to notify the plug-in once it is deleted. See NPN_GetURL for information about this parameter.

참고

Document Tags and Contributors

Contributors to this page: YoungguChae
Last updated by: YoungguChae,