src/TortoisePlink/Windows/cryptoapi.h

   1 /*
   2  * cryptoapi.h: Windows Crypto API functions defined in PuTTY that
   3  * use the crypt32 library. Also centralises the machinery for
   4  * dynamically loading that library, and our own functions using that
   5  * in turn.
   6  */
   7
   8 DECL_WINDOWS_FUNCTION(extern, BOOL, CryptProtectMemory, (LPVOID,DWORD,DWORD));
   9
  10 bool got_crypt(void);
  11
  12 /*
  13  * Function to obfuscate an input string into something usable as a
  14  * pathname for a Windows named pipe. Uses CryptProtectMemory to make
  15  * the obfuscation depend on a key Windows stores for the owning user,
  16  * and then hashes the string as well to make it have a manageable
  17  * length and be composed of filename-legal characters.
  18  *
  19  * Rationale: Windows's named pipes all live in the same namespace, so
  20  * one user can see what pipes another user has open. This is an
  21  * undesirable privacy leak: in particular, if we used unobfuscated
  22  * names for the connection-sharing pipe names, it would permit one
  23  * user to know what username@host another user is SSHing to.
  24  *
  25  * The returned string is dynamically allocated.
  26  */
  27 char *capi_obfuscate_string(const char *realname);