Compartilhar via


CInternetSession::GetCookie

Essa função de membro implementa o comportamento da função InternetGetCookieWin32, como descrito em Windows SDK.

static BOOL GetCookie( 
   LPCTSTR pstrUrl, 
   LPCTSTR pstrCookieName, 
   LPTSTR pstrCookieData, 
   DWORD dwBufLen  
); 
static BOOL GetCookie( 
   LPCTSTR pstrUrl, 
   LPCTSTR pstrCookieName, 
   CString& strCookieData  
);

Parâmetros

  • pstrUrl
    Um ponteiro para uma cadeia de caracteres que contém o URL.

  • pstrCookieName
    Um ponteiro para uma cadeia de caracteres que contém o nome do cookie para obter para o URL especificado.

  • pstrCookieData
    Em a primeira sobrecarga, um ponteiro para uma cadeia de caracteres que contém o endereço de buffer que recebe os dados do cookie. Esse valor pode ser NULO. Em a segunda sobrecarga, uma referência a um objeto de CString para receber os dados do cookie.

  • dwBufLen
    A variável que especifica o tamanho do buffer de pstrCookieData . Se a função for bem sucedida, o buffer recebe a quantidade de dados copiados para o buffer de pstrCookieData . Se pstrCookieData é NULO, este parâmetro recebe um valor que especifica o tamanho do buffer necessário copiar todos os dados do cookie.

Valor de retorno

Retorna se Verdadeiro com êxito, ou Falso caso contrário. Se a chamada falha, chame a função GetLastError Win32 para determinar a causa do erro. Os seguintes valores de erro se aplicam:

  • ERROR_NO_MORE_ITEMS não existirem cookie para o URL especificado e todos os seus pais.

  • ERROR_INSUFFICIENT_BUFFER o valor passado em dwBufLen insuficientes para copiar todos os dados do cookie. O valor retornado em dwBufLen é o tamanho do buffer necessário obter todos os dados.

Comentários

Em a segunda sobrecarga, o MFC recupera os dados do cookie no objeto fornecido de CString .

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

CInternetSession::GetCookieLength

CInternetSession::SetCookie